structure MIB_IF_ROW2 (netioapi.h)
La structure MIB_IF_ROW2 stocke des informations sur une interface particulière.
Syntaxe
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface : 1;
BOOLEAN FilterInterface : 1;
BOOLEAN ConnectorPresent : 1;
BOOLEAN NotAuthenticated : 1;
BOOLEAN NotMediaConnected : 1;
BOOLEAN Paused : 1;
BOOLEAN LowPower : 1;
BOOLEAN EndPointInterface : 1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Membres
InterfaceLuid
Type : NET_LUID
Identificateur local unique (LUID) pour l’interface réseau.
InterfaceIndex
Type : NET_IFINDEX
Index qui identifie l’interface réseau. Cette valeur d’index peut changer lorsqu’une carte réseau est désactivée, puis activée, et ne doit pas être considérée comme persistante.
InterfaceGuid
Type : GUID
GUID de l’interface réseau.
Alias[IF_MAX_STRING_SIZE + 1]
Type : WCHAR[IF_MAX_STRING_SIZE + 1]
Chaîne Unicode terminée par null qui contient le nom d’alias de l’interface réseau.
Description[IF_MAX_STRING_SIZE + 1]
Type : WCHAR[IF_MAX_STRING_SIZE + 1]
Chaîne Unicode terminée par null qui contient une description de l’interface réseau.
PhysicalAddressLength
Type : ULONG
Longueur, en octets, de l’adresse matérielle physique spécifiée par le membre PhysicalAddress .
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Type : UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Adresse matérielle physique de l’adaptateur pour cette interface réseau.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Type : UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Adresse matérielle physique permanente de l’adaptateur pour cette interface réseau.
Mtu
Type : ULONG
Taille maximale de l’unité de transmission (MTU), en octets, pour cette interface réseau.
Type
Type : IFTYPE
Type d’interface tel que défini par l’IANA (Internet Assigned Names Authority). Pour plus d’informations, consultez http://www.iana.org/assignments/ianaiftype-mib. Les valeurs possibles pour le type d’interface sont répertoriées dans le fichier d’en-tête Ipifcons.h .
Le tableau ci-dessous répertorie les valeurs communes pour le type d’interface, bien que de nombreuses autres valeurs soient possibles.
TunnelType
Type : TUNNEL_TYPE
Méthode d’encapsulation utilisée par un tunnel si le membre Type est IF_TYPE_TUNNEL. Le type de tunnel est défini par l’IANA (Internet Assigned Names Authority). Pour plus d’informations, consultez http://www.iana.org/assignments/ianaiftype-mib. Ce membre peut être l’une des valeurs du type d’énumération TUNNEL_TYPE défini dans le fichier d’en-tête Ifdef.h .
MediaType
Type : NDIS_MEDIUM
Type de média NDIS pour l’interface. Ce membre peut être l’une des valeurs du type d’énumération NDIS_MEDIUM défini dans le fichier d’en-tête Ntddndis.h .
PhysicalMediumType
Type : NDIS_PHYSICAL_MEDIUM
Type de support physique NDIS. Ce membre peut être l’une des valeurs du type d’énumération NDIS_PHYSICAL_MEDIUM défini dans le fichier d’en-tête Ntddndis.h .
AccessType
Type : NET_IF_ACCESS_TYPE
Type d’accès à l’interface. Ce membre peut être l’une des valeurs du type d’énumération NET_IF_ACCESS_TYPE défini dans le fichier d’en-tête Ifdef.h .
DirectionType
Type : NET_IF_DIRECTION_TYPE
Type de direction d’interface. Ce membre peut être l’une des valeurs du type d’énumération NET_IF_DIRECTION_TYPE défini dans le fichier d’en-tête Ifdef.h .
InterfaceAndOperStatusFlags
Ensemble d’indicateurs qui fournissent des informations sur l’interface. Ces indicateurs sont combinés à une opération OR au niveau du bit. Si aucun des indicateurs ne s’applique, ce membre est défini sur zéro.
InterfaceAndOperStatusFlags.HardwareInterface
Type : BOOLEAN Définissez si l’interface réseau est destinée au matériel.
InterfaceAndOperStatusFlags.FilterInterface
Type : BOOLEAN Définissez si l’interface réseau est pour un module de filtre.
InterfaceAndOperStatusFlags.ConnectorPresent
Type : BOOLEAN Définissez si un connecteur est présent sur l’interface réseau. Cette valeur est définie s’il existe une carte réseau physique.
InterfaceAndOperStatusFlags.NotAuthenticated
Type : BOOLEAN Définissez si le port par défaut de l’interface réseau n’est pas authentifié. Si une interface réseau n’est pas authentifiée par la cible, l’interface réseau n’est pas en mode opérationnel. Bien que cela s’applique aux connexions réseau câblées et sans fil, l’authentification est plus courante pour les connexions réseau sans fil.
InterfaceAndOperStatusFlags.NotMediaConnected
Type : BOOLEAN Définissez si l’interface réseau n’est pas dans un état connecté au média. Si un câble réseau est débranché pour un réseau câblé, ce paramètre est défini. Pour un réseau sans fil, cette option est définie pour la carte réseau qui n’est pas connectée à un réseau.
InterfaceAndOperStatusFlags.Paused
Type : BOOLEAN Définissez si la pile réseau de l’interface réseau est en pause ou en pause. Cela ne signifie pas que l’ordinateur est dans un état hibernated.
InterfaceAndOperStatusFlags.LowPower
Type : BOOLEAN Définissez si l’interface réseau est dans un état de faible consommation.
InterfaceAndOperStatusFlags.EndPointInterface
Type : BOOLEAN Définissez si l’interface réseau est un appareil de point de terminaison et non une véritable interface réseau qui se connecte à un réseau. Cela peut être défini par des appareils tels que les téléphones intelligents qui utilisent l’infrastructure réseau pour communiquer avec le PC, mais qui ne fournissent pas de connectivité à un réseau externe. Il est obligatoire pour ces types d’appareils de définir cet indicateur.
OperStatus
Type : IF_OPER_STATUS
Le status opérationnel pour l’interface telle que définie dans RFC 2863 en tant que IfOperStatus. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc2863.txt. Ce membre peut être l’une des valeurs du type d’énumération IF_OPER_STATUS défini dans le fichier d’en-tête Ifdef.h .
AdminStatus
Type : NET_IF_ADMIN_STATUS
Le status d’administration pour l’interface comme défini dans RFC 2863. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc2863.txt. Ce membre peut être l’une des valeurs du type d’énumération NET_IF_ADMIN_STATUS défini dans le fichier d’en-tête Ifdef.h .
MediaConnectState
Type : NET_IF_MEDIA_CONNECT_STATE
État de connexion de l’interface. Ce membre peut être l’une des valeurs du type d’énumération NET_IF_MEDIA_CONNECT_STATE défini dans le fichier d’en-tête Ifdef.h .
NetworkGuid
Type : NET_IF_NETWORK_GUID
GUID associé au réseau auquel appartient l’interface.
ConnectionType
Type : NET_IF_CONNECTION_TYPE
Type de connexion d’interface réseau NDIS. Ce membre peut être l’une des valeurs du type d’énumération NET_IF_CONNECTION_TYPE défini dans le fichier d’en-tête Ifdef.h .
TransmitLinkSpeed
Type : ULONG64
Vitesse en bits par seconde du lien de transmission.
ReceiveLinkSpeed
Type : ULONG64
Vitesse en bits par seconde du lien de réception.
InOctets
Type : ULONG64
Nombre d’octets de données reçues sans erreur via cette interface. Cette valeur inclut les octets dans les paquets unicast, broadcast et multidiffusion.
InUcastPkts
Type : ULONG64
Nombre de paquets en unidiffusion reçus sans erreur via cette interface.
InNUcastPkts
Type : ULONG64
Nombre de paquets non unicast reçus sans erreur via cette interface. Cette valeur inclut les paquets de diffusion et de multidiffusion.
InDiscards
Type : ULONG64
Nombre de paquets entrants qui ont été choisis pour être ignorés, même si aucune erreur n’a été détectée pour empêcher les paquets d’être livrables dans un protocole de couche supérieure.
InErrors
Type : ULONG64
Nombre de paquets entrants qui ont été ignorés en raison d’erreurs.
InUnknownProtos
Type : ULONG64
Nombre de paquets entrants qui ont été ignorés parce que le protocole était inconnu.
InUcastOctets
Type : ULONG64
Nombre d’octets de données reçus sans erreurs dans les paquets unicast via cette interface.
InMulticastOctets
Type : ULONG64
Nombre d’octets de données reçus sans erreurs dans les paquets de multidiffusion via cette interface.
InBroadcastOctets
Type : ULONG64
Nombre d’octets de données reçus sans erreurs dans les paquets de diffusion via cette interface.
OutOctets
Type : ULONG64
Nombre d’octets de données transmises sans erreur via cette interface. Cette valeur inclut les octets dans les paquets unicast, broadcast et multidiffusion.
OutUcastPkts
Type : ULONG64
Nombre de paquets unicast transmis sans erreur via cette interface.
OutNUcastPkts
Type : ULONG64
Nombre de paquets non unicast transmis sans erreur via cette interface. Cette valeur inclut les paquets de diffusion et de multidiffusion.
OutDiscards
Type : ULONG64
Nombre de paquets sortants qui ont été ignorés même s’ils n’avaient pas d’erreurs.
OutErrors
Type : ULONG64
Nombre de paquets sortants qui ont été ignorés en raison d’erreurs.
OutUcastOctets
Type : ULONG64
Nombre d’octets de données transmis sans erreurs dans les paquets unicast via cette interface.
OutMulticastOctets
Type : ULONG64
Nombre d’octets de données transmis sans erreurs dans les paquets de multidiffusion via cette interface.
OutBroadcastOctets
Type : ULONG64
Nombre d’octets de données transmises sans erreurs dans les paquets de diffusion via cette interface.
OutQLen
Type : ULONG64
Longueur de la file d’attente de transmission. Ce champ n’est pas utilisé actuellement.
Remarques
La structure MIB_IF_ROW2 est définie sur Windows Vista et versions ultérieures.
Les valeurs du champ Type sont définies dans le fichier d’en-tête Ipifcons.h . Seules les valeurs possibles répertoriées dans la description du membre Type sont actuellement prises en charge.
Notez que le fichier d’en-tête Netioapi.h est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Le fichier d’en-tête Netioapi.h ne doit jamais être utilisé directement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | netioapi.h (inclure Iphlpapi.h) |