structure MIB_IPNET_ROW2 (netioapi.h)
La structure MIB_IPNET_ROW2 stocke des informations sur une adresse IP voisine.
Syntaxe
typedef struct _MIB_IPNET_ROW2 {
SOCKADDR_INET Address;
NET_IFINDEX InterfaceIndex;
NET_LUID InterfaceLuid;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG PhysicalAddressLength;
NL_NEIGHBOR_STATE State;
union {
struct {
BOOLEAN IsRouter : 1;
BOOLEAN IsUnreachable : 1;
};
UCHAR Flags;
};
union {
ULONG LastReachable;
ULONG LastUnreachable;
} ReachabilityTime;
} MIB_IPNET_ROW2, *PMIB_IPNET_ROW2;
Membres
Address
Type : SOCKADDR_INET
Adresse IP du voisin. Ce membre peut être une adresse IPv6 ou une adresse IPv4.
InterfaceIndex
Type : NET_IFINDEX
Valeur d’index local de l’interface réseau associée à cette adresse IP. Cette valeur d’index peut changer lorsqu’une carte réseau est désactivée puis activée, ou dans d’autres circonstances, et ne doit pas être considérée comme persistante.
InterfaceLuid
Type : NET_LUID
Identificateur local unique (LUID) de l’interface réseau associée à cette adresse IP.
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Type : UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Adresse matérielle physique de la carte pour l’interface réseau associée à cette adresse IP.
PhysicalAddressLength
Type : ULONG
Longueur, en octets, de l’adresse matérielle physique spécifiée par le membre PhysicalAddress . La valeur maximale prise en charge est de 32 octets.
State
Type : NL_NEIGHBOR_STATE
État d’une adresse IP de voisin réseau, tel que défini dans RFC 2461, section 7.3.2. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc2461.txt. Ce membre peut être l’une des valeurs du type d’énumération NL_NEIGHBOR_STATE défini dans le fichier d’en-tête Nldef.h .
IsRouter
Type : BOOLEAN
Valeur qui indique si cette adresse IP est un routeur.
IsUnreachable
Type : BOOLEAN
Valeur qui indique si cette adresse IP est inaccessible.
Flags
Type : UCHAR
Ensemble d’indicateurs qui indiquent si l’adresse IP est un routeur et si l’adresse IP est inaccessible.
ReachabilityTime
ReachabilityTime.LastReachable
Type : ULONG Durée, en millisecondes, pendant laquelle un nœud suppose qu’un voisin est accessible après avoir reçu une confirmation d’accessibilité.
ReachabilityTime.LastUnreachable
Type : ULONG Durée, en millisecondes, pendant laquelle un nœud suppose qu’un voisin est inaccessible après n’avoir pas reçu de confirmation d’accessibilité.
Remarques
La structure MIB_IPNET_ROW2 est définie sur Windows Vista et versions ultérieures.
La fonction GetIpNetTable2 énumère les adresses IP voisines sur un système local et retourne ces informations dans une structure MIB_IPNET_TABLE2 .
Pour IPv4, cela inclut les adresses déterminées à l’aide du protocole de résolution d’adresses (ARP). Pour IPv6, cela inclut les adresses déterminées à l’aide du protocole de découverte de voisins (ND) pour IPv6, comme spécifié dans RFC 2461. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc2461.txt.
La fonction GetIpNetEntry2 récupère une seule adresse IP voisine et retourne ces informations dans une structure de MIB_IPNET_ROW2 .
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) |