MIB_IPNET_ROW2 structure

Article
03/08/2023

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

Adresse
Adresse IP du voisin. Ce membre peut être une adresse IPv6 ou une adresse IPv4.
InterfaceIndex
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
Identificateur local unique (LUID) pour l’interface réseau associée à cette adresse IP.
PhysicalAddress
Adresse matérielle physique de la carte pour l’interface réseau associée à cette adresse IP.
PhysicalAddressLength
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
Un NL_NEIGHBOR_STATE type d’état voisin de la couche réseau.
IsRouter
Valeur qui indique si cette adresse IP est un routeur.
IsUnreachable
Valeur qui indique si cette adresse IP est inaccessible.
Indicateurs
Ensemble d’indicateurs qui indiquent si l’adresse IP est un routeur et si l’adresse IP est inaccessible.
ReachabilityTime
Heure à laquelle le nœud suppose que le voisin est accessible ou inaccessible une fois que le nœud a reçu des informations sur l’accessibilité du voisin.

Cette union contient les membres suivants :
- LastReachable
  Durée, en millisecondes, pendant laquelle un nœud part du principe que le voisin reste accessible une fois que le nœud a reçu une confirmation d’accessibilité du voisin.
- LastUnreachable
  Durée, en millisecondes, pendant laquelle un nœud suppose que le voisin restera inaccessible une fois que le nœud ne reçoit pas de confirmation d’accessibilité de la part du voisin.

Notes

La fonction GetIpNetTable2 énumère les adresses IP voisines sur un ordinateur local et retourne ces informations dans une structure de MIB_IPNET_TABLE2 . Pour IPv4, ces informations incluent les adresses déterminées à l’aide du protocole ARP (Address Resolution Protocol). Pour IPv6, ces informations incluent 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 Découverte de voisins pour IP version 6 (IPv6).

La fonction GetIpNetEntry2 récupère une seule adresse IP voisine et retourne ces informations dans une structure de MIB_IPNET_ROW2.