WSCGetProviderPath, fonction (ws2spi.h)

Article
03/04/2024

La fonction WSCGetProviderPath récupère le chemin d’accès DLL du fournisseur spécifié.

Syntaxe

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

Paramètres

[in] lpProviderId

Pointeur vers un identificateur global unique (GUID) pour le fournisseur. Cette valeur est obtenue à l’aide de WSCEnumProtocols.

[out] lpszProviderDllPath

Pointeur vers une mémoire tampon dans laquelle la chaîne de chemin d’accès de la DLL du fournisseur est retournée. Le chemin d’accès est une chaîne terminée par null et toutes les chaînes d’environnement incorporées, telles que %SystemRoot%, n’ont pas été développées.

[in, out] lpProviderDllPathLen

Taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpszProviderDllPath .

[out] lpErrno

Pointeur vers le code d’erreur en cas d’échec de la fonction.

Valeur retournée

Si aucune erreur ne se produit, WSCGetProviderPath retourne zéro. Sinon, elle retourne SOCKET_ERROR. Le code d’erreur spécifique est disponible dans lpErrno.

Code d'erreur	Signification
WSAEINVAL	Le paramètre lpProviderId ne spécifie pas de fournisseur valide.
WSAEFAULT	Le paramètre lpszProviderDllPath ou lpErrno ne se trouve pas dans une partie valide de l’espace d’adressage utilisateur, ou lpProviderDllPathLen est trop petit.

Remarques

La fonction WSCGetProviderPath récupère le chemin d’accès DLL du fournisseur spécifié. Le chemin d’accès dll peut contenir des chaînes d’environnement incorporées, telles que %SystemRoot%, et doit donc être développé avant d’être utilisé avec la fonction Windows LoadLibrary . Pour plus d’informations, consultez LoadLibrary.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ws2spi.h
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll

Voir aussi

WSCEnumProtocols

WSCInstallProvider

Partager via