Funzione WSCGetProviderPath (ws2spi.h)
La funzione WSCGetProviderPath recupera il percorso DLL per il provider specificato.
Sintassi
int WSCGetProviderPath(
[in] LPGUID lpProviderId,
[out] WCHAR *lpszProviderDllPath,
[in, out] LPINT lpProviderDllPathLen,
[out] LPINT lpErrno
);
Parametri
[in] lpProviderId
Puntatore a un identificatore univoco globale (GUID) per il provider. Questo valore viene ottenuto usando WSCEnumProtocols.
[out] lpszProviderDllPath
Puntatore a un buffer in cui viene restituita la stringa di percorso della DLL del provider. Il percorso è una stringa con terminazione Null e le stringhe di ambiente incorporate, ad esempio %SystemRoot%, non sono state espanse.
[in, out] lpProviderDllPathLen
Dimensione, in caratteri, del buffer a cui punta il parametro lpszProviderDllPath .
[out] lpErrno
Puntatore al codice di errore se la funzione ha esito negativo.
Valore restituito
Se non si verifica alcun errore, WSCGetProviderPath restituisce zero. In caso contrario, restituisce SOCKET_ERROR. Il codice di errore specifico è disponibile in lpErrno.
| Codice di errore | Significato |
|---|---|
| Il parametro lpProviderId non specifica un provider valido. | |
| Il parametro lpszProviderDllPath o lpErrno non è incluso in una parte valida dello spazio indirizzi utente oppure lpProviderDllPathLen è troppo piccolo. |
Commenti
La funzione WSCGetProviderPath 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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |