WNetGetProviderNameA, fonction (winnetwk.h)

Article
11/20/2024

La fonction WNetGetProviderName obtient le nom du fournisseur pour un type spécifique de réseau.

Syntaxe

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Paramètres

[in] dwNetType

Type de réseau unique 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 élevé du type de réseau est utilisé. Si un réseau signale un sous-type dans le mot bas, il est ignoré.

Vous trouverez la 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 de retour

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 , par exemple l’une des valeurs suivantes.

Retourner le code	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

Note

L’en-tête winnetwk.h définit WNetGetProviderName comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winnetwk.h
bibliothèque	Mpr.lib
DLL	Mpr.dll

Voir aussi

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Vue d’ensemble mise en réseau Windows (WNet)

fonctions de mise en réseau Windows

Partager via