Fungsi WSCUnInstallNameSpace32 (ws2spi.h)

Artikel
08/28/2023

Fungsi WSCUnInstallNameSpace32 menghapus instalasi penyedia namespace 32-bit tertentu.

Catatan Panggilan ini adalah WSCUnInstallNameSpace versi 32-bit yang ketat untuk digunakan pada platform 64-bit. Ini disediakan untuk memungkinkan proses 64-bit mengakses katalog 32-bit.

Sintaks

INT WSCUnInstallNameSpace32(
  [in] LPGUID lpProviderId
);

Parameter

[in] lpProviderId

Penunjuk ke pengidentifikasi unik global (GUID) agar penyedia ruang nama dihapus instalannya.

Menampilkan nilai

Jika tidak ada kesalahan yang terjadi, WSCUnInstallNameSpace32 mengembalikan NO_ERROR (nol). Jika tidak, ia mengembalikan SOCKET_ERROR jika fungsi gagal, dan Anda harus mengambil kode kesalahan yang sesuai menggunakan fungsi WSAGetLastError .

Kode kesalahan	Makna
WSAEFAULT	Parameter lpProviderId menunjuk ke memori yang tidak berada di bagian ruang alamat pengguna yang valid.
WSAEINVAL	Pengidentifikasi namespace–penyedia yang ditentukan tidak valid.
WSASYSCALLFAILURE	Panggilan sistem yang seharusnya tidak pernah gagal gagal.
WSA_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia. Kesalahan ini dikembalikan ketika memori tidak cukup untuk mengalokasikan entri katalog baru.

Keterangan

WSCUnInstallNameSpace32 adalah WSCUnInstallNameSpace versi 32-bit yang ketat. Pada komputer 64-bit, semua panggilan tidak secara khusus 32-bit (misalnya, semua fungsi yang tidak berakhiran "32") beroperasi pada katalog 64-bit asli. Proses yang dijalankan pada komputer 64-bit harus menggunakan panggilan fungsi 32-bit tertentu untuk beroperasi pada katalog 32-bit yang ketat dan mempertahankan kompatibilitas. Definisi dan semantik panggilan 32-bit tertentu sama dengan rekan-rekan aslinya.

Fungsi konfigurasi namespace tidak memengaruhi aplikasi yang sudah berjalan. Penyedia ruang nama yang baru diinstal tidak akan terlihat oleh aplikasi atau perubahan dalam status aktivasi penyedia ruang nama. Aplikasi yang diluncurkan setelah panggilan ke WSCUnInstallNameSpace32 akan mengenali perubahan.

Jika berhasil, WSCUnInstallNameSpace32 akan mencoba memperingatkan semua aplikasi yang tertarik yang telah mendaftar untuk pemberitahuan perubahan dengan memanggil WSAProviderConfigChange.

Fungsi WSCUnInstallNameSpace32 hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika WSCUnInstallNameSpace32 dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal dan WSANO_RECOVERY dikembalikan dalam parameter lpErrno .

Untuk komputer yang berjalan pada 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 diatur ke requireAdministrator. Jika aplikasi pada 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


Klien minimum yang didukung	Windows Vista, Windows XP Professional x64 Edition [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008, Windows Server 2003 x64 Edition [hanya aplikasi desktop]
Target Platform	Windows
Header	ws2spi.h
Pustaka	Ws2_32.lib
DLL	Ws2_32.dll