Fungsi WSCEnumNameSpaceProvidersEx32 (ws2spi.h)

Artikel
08/28/2023

Fungsi WSCEnumNameSpaceProvidersEx32 mengambil informasi tentang penyedia namespace 32-bit yang tersedia.

Sintaks

INT WSAAPI WSCEnumNameSpaceProvidersEx32(
  [in, out] LPDWORD                lpdwBufferLength,
  [out]     LPWSANAMESPACE_INFOEXW lpnspBuffer
);

Parameter

[in, out] lpdwBufferLength

Pada input, jumlah byte yang terkandung dalam buffer yang diacu oleh lpnspBuffer. Pada output (jika fungsi gagal, dan kesalahannya adalah WSAEFAULT), jumlah minimum byte yang akan dialokasikan untuk buffer lpnspBuffer untuk memungkinkannya mengambil semua informasi yang diminta. Buffer yang diteruskan ke WSCEnumNameSpaceProvidersEx32 harus cukup untuk menyimpan semua informasi namespace.

[out] lpnspBuffer

Buffer yang diisi dengan struktur WSANAMESPACE_INFOEXW . Struktur yang dikembalikan terletak berturut-turut di kepala buffer. Informasi berukuran variabel yang direferensikan oleh pointer dalam struktur menunjuk ke lokasi dalam buffer yang terletak di antara akhir struktur berukuran tetap dan akhir buffer. Jumlah struktur yang diisi adalah nilai pengembalian WSCEnumNameSpaceProvidersEx32.

Mengembalikan nilai

Fungsi WSCEnumNameSpaceProvidersEx32 mengembalikan jumlah struktur WSANAMESPACE_INFOEXW yang disalin ke dalam lpnspBuffer. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.

Kode kesalahan	Makna
WSAEFAULT	Panjang buffer terlalu kecil untuk menerima semua struktur WSANAMESPACE_INFOEXW yang relevan dan informasi terkait atau parameter lpnspBuffer adalah penunjuk NULL. Ketika kesalahan ini dikembalikan, panjang buffer yang diperlukan dikembalikan dalam parameter lpdwBufferLength .
WSANOTINITIALISED	WS2_32.DLL belum diinisialisasi. Aplikasi harus terlebih dahulu memanggil WSAStartup sebelum memanggil fungsi Windows Sockets apa pun.
WSA_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk melakukan operasi.

Keterangan

WSCEnumNameSpaceProvidersEx32 adalah WSAEnumNameSpaceProvidersEx versi 32-bit. Pada komputer 64-bit, semua panggilan tidak secara khusus 32-bit (misalnya, semua fungsi yang tidak berakhiran "32") beroperasi pada katalog asli 64-bit. 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.

Saat ini, satu-satunya namespace yang disertakan dengan Windows yang menggunakan informasi di anggota ProviderSpecific dari struktur WSANAMESPACE_INFOEXW adalah penyedia namespace layanan untuk namespace NS_EMAIL. Format anggota ProviderSpecific untuk penyedia namespace NS_EMAIL adalah struktur NAPI_PROVIDER_INSTALLATION_BLOB .

Fungsi SPI 32-bit setara dengan fungsi API asli (WSAEnumNameSpaceProvidersEx) karena tidak ada konsep penyedia namespace layanan "tersembunyi".

Blob data khusus penyedia yang terkait dengan entri namespace yang diteruskan dalam parameter lpProviderInfo ke fungsi WSCInstallNameSpaceEx32 dapat dikueri menggunakan fungsi WSCEnumNameSpaceProvidersEx32 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	ws2spi.h
Pustaka	Ws2_32.lib
DLL	Ws2_32.dll