WNetGetNetworkInformationA, fonction (winnetwk.h)

Article
08/27/2023

La fonction WNetGetNetworkInformation retourne des informations étendues sur un fournisseur de réseau spécifique dont le nom a été retourné par une énumération réseau précédente.

Syntaxe

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

Paramètres

[in] lpProvider

Pointeur vers une chaîne constante terminée par un caractère Null qui contient le nom du fournisseur de réseau pour lequel des informations sont requises.

[out] lpNetInfoStruct

Pointeur vers une structure NETINFOSTRUCT . La structure décrit les caractéristiques du réseau.

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_BAD_PROVIDER	Le paramètre lpProvider ne correspond à aucun fournisseur réseau en cours d’exécution.
ERROR_BAD_VALUE	Le membre cbStructure de la structure NETINFOSTRUCT ne contient pas de taille de structure valide.

Remarques

Notes

L’en-tête winnetwk.h définit WNetGetNetworkInformation 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


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