WNetGetProviderNameA, fonction (winnetwk.h)
La fonction WNetGetProviderName obtient le nom du fournisseur pour un type de réseau spécifique.
Syntaxe
DWORD WNetGetProviderNameA(
[in] DWORD dwNetType,
[out] LPSTR lpProviderName,
[in, out] LPDWORD lpBufferSize
);
Paramètres
[in] dwNetType
Type de réseau propre au réseau. Si deux réseaux revendiquent le même type, la fonction retourne le nom du fournisseur chargé en premier. Seul le mot haut du type de réseau est utilisé. Si un réseau signale un sous-type dans le mot bas, il est ignoré.
Vous trouverez une liste complète des types de réseau dans le fichier d’en-tête Winnetwk.h.
[out] lpProviderName
Pointeur vers une mémoire tampon qui reçoit le nom du fournisseur de réseau.
[in, out] lpBufferSize
Taille de la mémoire tampon passée à la fonction, en caractères. Si la valeur de retour est ERROR_MORE_DATA, lpBufferSize retourne la taille de mémoire tampon requise (en caractères) pour contenir le nom du fournisseur.
Windows Me/98/95 : La taille de la mémoire tampon est en octets, et non en caractères. En outre, la mémoire tampon doit avoir au moins 1 octet de long.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, la valeur de retour est un code d’erreur système, comme l’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
La mémoire tampon est trop petite pour contenir le nom du fournisseur de réseau. |
|
Le réseau n'est pas disponible. |
|
Le paramètre lpProviderName ou le paramètre lpBufferSize n’est pas valide. |
Remarques
Notes
L’en-tête winnetwk.h définit WNetGetProviderName en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 | winnetwk.h |
Bibliothèque | Mpr.lib |
DLL | Mpr.dll |