Partager via

Structure NETINFOSTRUCT (winnetwk.h)

  • Article

La structure NETINFOSTRUCT contient des informations décrivant le fournisseur réseau retourné par la fonction WNetGetNetworkInformation .

Syntaxe

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Membres

cbStructure

Type : DWORD

Taille, en octets, de la structure NETINFOSTRUCT . L’appelant doit fournir cette valeur pour indiquer la taille de la structure passée. Au retour, la taille de la structure est remplie.

dwProviderVersion

Type : DWORD

Numéro de version du logiciel du fournisseur de réseau.

dwStatus

Type : DWORD

La status actuelle du logiciel du fournisseur de réseau. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
NO_ERROR
 Le réseau est en cours d’exécution.
ERROR_NO_NETWORK
 Le réseau n'est pas disponible.
ERROR_BUSY
 Le réseau n’est actuellement pas en mesure de traiter les demandes, mais il devrait être disponible sous peu. (Cette valeur indique généralement que le réseau est en cours de démarrage.)

dwCharacteristics

Type : DWORD

Caractéristiques du logiciel du fournisseur de réseau.

Cette valeur est égale à zéro.

Windows Me/98/95 : Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
NETINFO_DLL16
 Le fournisseur de réseau s’exécute en tant que pilote réseau Windows 16 bits.
NETINFO_DISKRED
 Le fournisseur de réseau nécessite un périphérique de lecteur de disque local redirigé pour accéder aux systèmes de fichiers du serveur.
NETINFO_PRINTERRED
 Le fournisseur de réseau nécessite un port d’imprimante local redirigé pour accéder aux systèmes de fichiers du serveur.

dwHandle

Type : ULONG_PTR

Un handle instance pour le fournisseur réseau ou pour le pilote réseau Windows 16 bits.

wNetType

Type : WORD

Type de réseau propre au réseau en cours d’exécution. Cette valeur associe des ressources à un réseau spécifique lorsque les ressources sont persistantes ou stockées dans des liens. Vous trouverez une liste complète des types de réseau dans le fichier d’en-tête Winnetwk.h.

dwPrinters

Type : DWORD

Ensemble d’indicateurs de bits indiquant les numéros d’impression valides pour la redirection des périphériques d’imprimante locaux, avec le bit d’ordre inférieur correspondant à LPT1.

Windows Me/98/95 : Cette valeur est toujours définie sur –1.

dwDrives

Type : DWORD

Ensemble d’indicateurs de bits indiquant les périphériques de disque local valides pour la redirection des lecteurs de disque, avec le bit d’ordre inférieur correspondant à A :.

Windows Me/98/95 : Cette valeur est toujours définie sur –1.

Remarques

La structure NETINFOSTRUCT contient des informations décrivant le réseau, telles que la version du logiciel du fournisseur de réseau et la status actuelle du réseau.

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]
En-tête winnetwk.h

Voir aussi

WNetGetNetworkInformation

Vue d’ensemble de Windows Networking (WNet)

Structures de mise en réseau Windows