Fungsi WSCDeinstallProvider (ws2spi.h)
Fungsi WSCDeinstallProvider menghapus penyedia transportasi yang ditentukan dari database konfigurasi sistem.
Sintaks
int WSCDeinstallProvider(
[in] LPGUID lpProviderId,
[out] LPINT lpErrno
);
Parameter
[in] lpProviderId
Penunjuk ke pengidentifikasi unik global (GUID) untuk penyedia. Nilai ini disimpan dalam setiap struktur WSAProtocol_Info .
[out] lpErrno
Penunjuk ke kode kesalahan jika fungsi gagal.
Mengembalikan nilai
Jika tidak ada kesalahan yang terjadi, WSCDeinstallProvider mengembalikan nol. Jika tidak, ia mengembalikan SOCKET_ERROR, dan kode kesalahan tertentu tersedia di lpErrno.
Kode kesalahan | Makna |
---|---|
Parameter lpProviderId tidak menentukan penyedia yang valid. | |
Parameter lpErrno tidak berada di bagian ruang alamat pengguna yang valid. | |
Terjadi kesalahan yang tidak dapat dipulihkan. Kesalahan ini dikembalikan dalam beberapa kondisi termasuk yang berikut ini: pengguna tidak memiliki hak istimewa administratif yang diperlukan untuk menulis ke registri Windows Sockets, atau kegagalan terjadi saat membuka entri katalog. | |
Memori tidak cukup tersedia. Kesalahan ini dikembalikan ketika memori tidak cukup untuk mengalokasikan entri katalog baru. |
Keterangan
Fungsi WSCDeinstallProvider menghapus informasi konfigurasi Windows Sockets 2 umum untuk penyedia yang ditentukan. Setelah rutinitas ini berhasil diselesaikan, informasi konfigurasi yang disimpan dalam registri akan diubah. Namun, instans Ws2_32.dll apa pun yang saat ini berada dalam memori tidak akan dapat mengenali perubahan ini.
Setelah berhasil, WSCDeinstallProvider akan mencoba memperingatkan semua aplikasi yang tertarik yang telah mendaftar untuk pemberitahuan perubahan dengan memanggil WSAProviderConfigChange.
Fungsi WSCDeinstallProvider hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika WSCDeinstallProvider dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal dan WSANO_RECOVERY dikembalikan dalam parameter lpErrno .
Untuk komputer yang menjalankan Windows Vista atau Windows Server 2008, fungsi ini juga dapat gagal karena kontrol akun pengguna (UAC). Jika aplikasi yang berisi fungsi ini dijalankan oleh pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan, panggilan ini akan gagal kecuali aplikasi telah ditandai dalam file manifes dengan requestedExecutionLevel yang diatur ke requireAdministrator. Jika aplikasi di Windows Vista atau Windows Server 2008 tidak memiliki file manifes ini, pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan kemudian harus menjalankan aplikasi dalam shell yang ditingkatkan sebagai Administrator bawaan (administrator RunAs) agar fungsi ini berhasil.
Pemanggil fungsi ini harus menghapus file tambahan atau informasi konfigurasi khusus penyedia layanan yang diperlukan untuk menghapus instalan penyedia layanan sepenuhnya.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | ws2spi.h |
Pustaka | Ws2_32.lib |
DLL | Ws2_32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk