Fungsi WSCGetProviderPath (ws2spi.h)

Artikel
03/04/2024

Fungsi WSCGetProviderPath mengambil jalur DLL untuk penyedia yang ditentukan.

Sintaks

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

Parameter

[in] lpProviderId

Penunjuk ke pengidentifikasi unik global (GUID) untuk penyedia. Nilai ini diperoleh dengan menggunakan WSCEnumProtocols.

[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, dalam karakter, dari buffer yang ditujukkan oleh parameter lpszProviderDllPath .

[out] lpErrno

Penunjuk ke kode kesalahan jika fungsi gagal.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, WSCGetProviderPath 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

Fungsi WSCGetProviderPath 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

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

Lihat juga

WSCEnumProtocols

WSCInstallProvider

Bagikan melalui