WSCGetProviderPath32-Funktion (ws2spi.h)

  • Artikel

Die WSCGetProviderPath32-Funktion ruft den DLL-Pfad für den angegebenen 32-Bit-Anbieter ab.

Hinweis Bei diesem Aufruf handelt es sich um eine streng 32-Bit-Version von WSCGetProviderPath für die Verwendung auf 64-Bit-Plattformen. Es wird bereitgestellt, um 64-Bit-Prozessen den Zugriff auf die 32-Bit-Kataloge zu ermöglichen.

 

Syntax

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

Parameter

[in] lpProviderId

Lokal eindeutiger Bezeichner des Anbieters. Dieser Wert wird mithilfe von WSCEnumProtocols32 abgerufen.

[out] lpszProviderDllPath

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

Größe des Puffers, auf den der parameter lpszProviderDllPath in Zeichen verweist.

[out] lpErrno

Zeiger auf den Fehlercode.

Rückgabewert

Wenn kein Fehler auftritt, gibt WSCGetProviderPath32 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

WSCGetProviderPath32 ist eine streng 32-Bit-Version von WSCGetProviderPath. Auf einem 64-Bit-Computer werden alle Aufrufe, die nicht speziell 32-Bit-Aufrufe (z. B. alle Funktionen, die nicht auf "32" enden) im nativen 64-Bit-Katalog ausgeführt. Prozesse, die auf einem 64-Bit-Computer ausgeführt werden, müssen die spezifischen 32-Bit-Funktionsaufrufe verwenden, um mit einem strikten 32-Bit-Katalog zu arbeiten und die Kompatibilität aufrechtzuerhalten. Die Definitionen und Semantik der spezifischen 32-Bit-Aufrufe sind identisch mit ihren nativen Gegenstücken.

Die WSCGetProviderPath32-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

   
Unterstützte Mindestversion (Client) Windows Vista, Windows XP Professional x64 Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008, Windows Server 2003 x64 Edition [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ws2spi.h
Bibliothek Ws2_32.lib
DLL Ws2_32.dll

Weitere Informationen

WSCEnumProtocols32

WSCInstallProvider64_32