Funzione WSCGetProviderPath32 (ws2spi.h)

Articolo
08/28/2023

La funzione WSCGetProviderPath32 recupera il percorso DLL per il provider a 32 bit specificato.

Nota Questa chiamata è una versione strettamente a 32 bit di WSCGetProviderPath per l'uso su piattaforme a 64 bit. Viene fornito per consentire ai processi a 64 bit di accedere ai cataloghi a 32 bit.

Sintassi

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

Parametri

[in] lpProviderId

Identificatore univoco locale del provider. Questo valore viene ottenuto usando WSCEnumProtocols32.

[out] lpszProviderDllPath

Puntatore a un buffer in cui viene restituita la stringa del percorso della DLL del provider. Il percorso è una stringa con terminazione null e tutte le stringhe di ambiente incorporate, ad esempio %SystemRoot%, non sono state espanse.

[in, out] lpProviderDllPathLen

Dimensioni del buffer a cui punta il parametro lpszProviderDllPath , in caratteri.

[out] lpErrno

Puntatore al codice di errore.

Valore restituito

Se non si verifica alcun errore, WSCGetProviderPath32 restituisce zero. In caso contrario, restituisce SOCKET_ERROR. Il codice di errore specifico è disponibile in lpErrno.

Codice di errore	Significato
WSAEINVAL	Il parametro lpProviderId non specifica un provider valido.
WSAEFAULT	Il parametro lpszProviderDllPath o lpErrno non è incluso in una parte valida dello spazio degli indirizzi utente o lpProviderDllPathLen è troppo piccolo.

Commenti

WSCGetProviderPath32 è una versione strettamente a 32 bit di WSCGetProviderPath. In un computer a 64 bit tutte le chiamate non in particolare a 32 bit (ad esempio tutte le funzioni che non terminano in "32") operano nel catalogo a 64 bit nativo. I processi eseguiti in un computer a 64 bit devono usare le chiamate di funzione a 32 bit specifiche per operare su un catalogo a 32 bit e mantenere la compatibilità. Le definizioni e la semantica delle chiamate a 32 bit specifiche sono uguali a quelle native.

La funzione WSCGetProviderPath32 recupera il percorso DLL per il provider specificato. Il percorso DLL può contenere stringhe di ambiente incorporate, ad esempio %SystemRoot%, e quindi deve essere espanso prima di essere usato con la funzione Windows LoadLibrary . Per altre informazioni, vedere LoadLibrary.

Requisiti


Client minimo supportato	Windows Vista, Windows XP Professional x64 Edition [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 x64 Edition [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ws2spi.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll

Vedi anche

WSCEnumProtocols32

WSCInstallProvider64_32

Condividi tramite