WNetGetNetworkInformationA, fonction (winnetwk.h)

Article
11/20/2024

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 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 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_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

Note

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