Fungsi WSCEnumNameSpaceProviders32 (ws2spi.h)
Fungsi WSCEnumNameSpaceProviders32 mengembalikan informasi tentang penyedia namespace 32-bit yang tersedia.
Sintaks
INT WSAAPI WSCEnumNameSpaceProviders32(
[in, out] LPDWORD lpdwBufferLength,
[out] LPWSANAMESPACE_INFOW 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 WSCEnumNameSpaceProviders32 harus cukup untuk menyimpan semua informasi namespace.
[out] lpnspBuffer
Buffer yang diisi dengan struktur WSANAMESPACE_INFOW . Struktur yang dikembalikan terletak secara 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 WSCEnumNameSpaceProviders32.
Mengembalikan nilai
Fungsi WSCEnumNameSpaceProviders32 mengembalikan jumlah struktur WSANAMESPACE_INFOW yang disalin ke dalam lpnspBuffer. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.
| Kode kesalahan | Makna |
|---|---|
| Parameter lpnspBuffer adalah penunjuk **NULL** atau panjang buffer, lpdwBufferLength, terlalu kecil untuk menerima semua struktur WSANAMESPACE_INFOW yang relevan dan informasi terkait. Ketika kesalahan ini dikembalikan, panjang buffer yang diperlukan dikembalikan dalam parameter lpdwBufferLength . | |
| WS2_32.DLL belum diinisialisasi. Aplikasi harus terlebih dahulu memanggil WSAStartup sebelum memanggil fungsi Windows Sockets apa pun. | |
| Memori tidak cukup untuk melakukan operasi. |
Keterangan
WSCEnumNameSpaceProviders32 adalah WSAEnumNameSpaceProviders 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 SPI 32-bit setara dengan fungsi API asli (WSAEnumNameSpaceProviders) karena tidak ada konsep penyedia namespace "tersembunyi".
Fungsi WSCEnumNameSpaceProviders32 adalah fungsi unicode saja dan mengembalikan struktur WSANAMESPACE_INFOEXW .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |