WNetGetProviderNameA, fonction (winnetwk.h)

  • Article

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
ERROR_MORE_DATA
 La mémoire tampon est trop petite pour contenir le nom du fournisseur de réseau.
ERROR_NO_NETWORK
 Le réseau n'est pas disponible.
ERROR_INVALID_ADDRESS
 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

Voir aussi

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Vue d’ensemble de Windows Networking (WNet)

Fonctions de mise en réseau Windows