Fungsi WSCInstallNameSpace32 (ws2spi.h)
Fungsi WSCInstallNameSpace32 menginstal penyedia namespace 32-bit tertentu. Untuk penyedia yang dapat mendukung beberapa namespace, fungsi ini harus dipanggil untuk setiap namespace yang didukung, dan pengidentifikasi penyedia unik harus disediakan setiap kali.
Sintaks
INT WSCInstallNameSpace32(
[in] LPWSTR lpszIdentifier,
[in] LPWSTR lpszPathName,
[in] DWORD dwNameSpace,
[in] DWORD dwVersion,
[in] LPGUID lpProviderId
);
Parameter
[in] lpszIdentifier
Penunjuk ke string yang mengidentifikasi penyedia yang terkait dengan pengidentifikasi unik global (GUID) yang diteruskan dalam parameter lpProviderId .
[in] lpszPathName
Penunjuk ke string yang berisi jalur ke gambar DLL penyedia. String mengamati aturan biasa untuk resolusi jalur: jalur ini dapat berisi string lingkungan yang disematkan (seperti %SystemRoot%). String lingkungan tersebut diperluas setiap kali WS2_32.DLL harus memuat DLL penyedia atas nama aplikasi. Setelah string lingkungan yang disematkan diperluas, Ws2_32.dll meneruskan string yang dihasilkan ke dalam fungsi LoadLibrary untuk memuat penyedia ke dalam memori. Untuk informasi selengkapnya, lihat LoadLibrary.
[in] dwNameSpace
Deskriptor yang menentukan namespace yang didukung oleh penyedia ini.
[in] dwVersion
Deskriptor yang menentukan nomor versi penyedia.
[in] lpProviderId
Pengidentifikasi unik untuk penyedia ini. GUID ini harus dihasilkan oleh Uuidgen.exe.
Mengembalikan nilai
Jika tidak ada kesalahan yang terjadi, fungsi WSCInstallNameSpace32 mengembalikan NO_ERROR (nol). Jika tidak, fungsi mengembalikan SOCKET_ERROR jika fungsi gagal, dan Anda harus mengambil kode kesalahan yang sesuai menggunakan fungsi WSAGetLastError .
| Kode kesalahan | Makna |
|---|---|
| Rutinitas panggilan tidak memiliki hak istimewa yang memadai untuk menginstal namespace. | |
| Satu atau beberapa argumen tidak valid. | |
| Terjadi kesalahan yang tidak dapat dipulihkan. Kesalahan ini dikembalikan dalam beberapa kondisi termasuk yang berikut ini: penyedia sudah diinstal, pengguna tidak memiliki hak istimewa administratif yang diperlukan untuk menulis ke registri Winsock, atau kegagalan terjadi saat membuat atau menginstal entri katalog. | |
| Panggilan sistem yang seharusnya tidak pernah gagal gagal. | |
| Memori tidak cukup tersedia. Kesalahan ini dikembalikan ketika memori tidak cukup untuk mengalokasikan entri katalog baru. |
Keterangan
WSCInstallNameSpace32 adalah WSCInstallNameSpace 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.
Fungsi konfigurasi namespace layanan tidak memengaruhi aplikasi yang sudah berjalan. Penyedia namespace layanan yang baru diinstal tidak akan terlihat oleh aplikasi juga tidak akan berubah dalam status aktivasi penyedia namespace. Aplikasi yang diluncurkan setelah panggilan ke WSCInstallNameSpace32 akan mengenali perubahan.
Fungsi WSCInstallNameSpace32 hanya dapat dipanggil oleh pengguna yang masuk sebagai anggota grup Administrator. Jika WSCInstallNameSpace32 dipanggil oleh pengguna yang bukan anggota grup Administrator, panggilan fungsi akan gagal. 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.
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 |