WSCGetProviderPath32, fonction (ws2spi.h)

Article
08/28/2023

La fonction WSCGetProviderPath32 récupère le chemin d’accès DLL pour le fournisseur 32 bits spécifié.

Note Cet appel est une version strictement 32 bits de WSCGetProviderPath à utiliser sur les plateformes 64 bits. Il est fourni pour permettre aux processus 64 bits d’accéder aux catalogues 32 bits.

Syntaxe

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

Paramètres

[in] lpProviderId

Identificateur unique localement du fournisseur. Cette valeur est obtenue à l’aide de WSCEnumProtocols32.

[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 de la mémoire tampon vers laquelle pointe le paramètre lpszProviderDllPath , en caractères.

[out] lpErrno

Pointeur vers le code d’erreur.

Valeur retournée

Si aucune erreur ne se produit, WSCGetProviderPath32 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

WSCGetProviderPath32 est une version strictement 32 bits de WSCGetProviderPath. Sur un ordinateur 64 bits, tous les appels ne sont pas spécifiquement 32 bits (par exemple, toutes les fonctions qui ne se terminent pas par « 32 ») fonctionnent sur le catalogue 64 bits natif. Les processus qui s’exécutent sur un ordinateur 64 bits doivent utiliser les appels de fonction 32 bits spécifiques pour fonctionner sur un catalogue strictement 32 bits et préserver la compatibilité. Les définitions et la sémantique des appels 32 bits spécifiques sont les mêmes que leurs équivalents natifs.

La fonction WSCGetProviderPath32 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.

Spécifications


Client minimal pris en charge	Windows Vista, Windows XP Professionnel Édition x64 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 Édition x64 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ws2spi.h
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll

Voir aussi

WSCEnumProtocols32

WSCInstallProvider64_32

Partager via