Fungsi WSCGetProviderPath32 (ws2spi.h)

Artikel
08/28/2023

Fungsi WSCGetProviderPath32 mengambil jalur DLL untuk penyedia 32-bit yang ditentukan.

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

Sintaks

int WSCGetProviderPath32(
  [in]      LPGUID lpProviderId,
  [out]     WCHAR  *lpszProviderDllPath,
  [in, out] LPINT  lpProviderDllPathLen,
  [out]     LPINT  lpErrno
);

Parameter

[in] lpProviderId

Pengidentifikasi penyedia yang unik secara lokal. Nilai ini diperoleh dengan menggunakan WSCEnumProtocols32.

[out] lpszProviderDllPath

Penunjuk ke buffer tempat string jalur DLL penyedia dikembalikan. Jalur adalah string yang dihentikan null dan string lingkungan yang disematkan, seperti %SystemRoot%, belum diperluas.

[in, out] lpProviderDllPathLen

Ukuran buffer yang ditujukkan oleh parameter lpszProviderDllPath , dalam karakter.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, WSCGetProviderPath32 mengembalikan nol. Jika tidak, ia mengembalikan SOCKET_ERROR. Kode kesalahan tertentu tersedia di lpErrno.

Kode kesalahan	Makna
WSAEINVAL	Parameter lpProviderId tidak menentukan penyedia yang valid.
WSAEFAULT	Parameter lpszProviderDllPath atau lpErrno tidak berada di bagian ruang alamat pengguna yang valid, atau lpProviderDllPathLen terlalu kecil.

Keterangan

WSCGetProviderPath32 adalah WSCGetProviderPath versi 32-bit. 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 WSCGetProviderPath32 mengambil jalur DLL untuk penyedia yang ditentukan. Jalur DLL dapat berisi string lingkungan yang disematkan, seperti %SystemRoot%, dan dengan demikian harus diperluas sebelum digunakan dengan fungsi Windows LoadLibrary . Untuk informasi selengkapnya, lihat LoadLibrary.

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

Lihat juga

WSCEnumProtocols32

WSCInstallProvider64_32

Bagikan melalui