WSCGetProviderPath-Funktion (ws2spi.h)

Artikel
03/04/2024

Die WSCGetProviderPath-Funktion ruft den DLL-Pfad für den angegebenen Anbieter ab.

Syntax

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

Parameter

[in] lpProviderId

Ein Zeiger auf einen Globally Unique Identifier (GUID) für den Anbieter. Dieser Wert wird mithilfe von WSCEnumProtocols abgerufen.

[out] lpszProviderDllPath

Ein Zeiger auf einen Puffer, in den die Pfadzeichenfolge der Anbieter-DLL zurückgegeben wird. Der Pfad ist eine NULL-Zeichenfolge, und alle eingebetteten Umgebungszeichenfolgen, z. B. %SystemRoot%, wurden nicht erweitert.

[in, out] lpProviderDllPathLen

Die Größe des Puffers in Zeichen, auf den der lpszProviderDllPath-Parameter verweist.

[out] lpErrno

Ein Zeiger auf den Fehlercode, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn kein Fehler auftritt, gibt WSCGetProviderPath null zurück. Andernfalls wird SOCKET_ERROR zurückgegeben. Der spezifische Fehlercode ist in lpErrno verfügbar.

Fehlercode	Bedeutung
WSAEINVAL	Der lpProviderId-Parameter gibt keinen gültigen Anbieter an.
WSAEFAULT	Der parameter lpszProviderDllPath oder lpErrno befindet sich nicht in einem gültigen Teil des Benutzeradressraums, oder lpProviderDllPathLen ist zu klein.

Hinweise

Die WSCGetProviderPath-Funktion ruft den DLL-Pfad für den angegebenen Anbieter ab. Der DLL-Pfad kann eingebettete Umgebungszeichenfolgen wie %SystemRoot% enthalten und sollte daher vor der Verwendung mit der Windows LoadLibrary-Funktion erweitert werden. Weitere Informationen finden Sie unter LoadLibrary.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ws2spi.h
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll

Weitere Informationen

WSCEnumProtocols

WSCInstallProvider

Freigeben über