structure MIB_IPFORWARD_ROW2
La structure MIB_IPFORWARD_ROW2 stocke des informations sur une entrée d’itinéraire IP.
Syntaxe
typedef struct _MIB_IPFORWARD_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
IP_ADDRESS_PREFIX DestinationPrefix;
SOCKADDR_INET NextHop;
UCHAR SitePrefixLength;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG Metric;
NL_ROUTE_PROTOCOL Protocol;
BOOLEAN Loopback;
BOOLEAN AutoconfigureAddress;
BOOLEAN Publish;
BOOLEAN Immortal;
ULONG Age;
NL_ROUTE_ORIGIN Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;
Membres
InterfaceLuid
Identificateur unique local (LUID) de l’interface réseau associée à cette entrée de route IP.InterfaceIndex
Valeur d’index local de l’interface réseau associée à cette entrée de route 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.DestinationPrefix
Préfixe d’adresse IP de l’adresse IP de destination pour cet itinéraire.NextHop
Pour un itinéraire distant, l’adresse IP du système ou de la passerelle suivant qui se trouve le long de l’itinéraire. Si l’itinéraire est vers une adresse de bouclage locale ou une adresse IP sur le lien local, le tronçon suivant n’est pas spécifié (tous les zéros). Pour un itinéraire de bouclage local, ce membre doit être une adresse IPv4 de 0.0.0.0 pour une entrée de route IPv4 ou une adresse IPv6 de 0::0 pour une entrée de route IPv6.SitePrefixLength
Longueur, en bits, du préfixe de site ou de la partie réseau de l’adresse IP de cet itinéraire. Pour une entrée de route IPv4, toute valeur supérieure à 32 est une valeur non valide. Pour une entrée de route IPv6, toute valeur supérieure à 128 est une valeur non valide. Une valeur de 255 est généralement utilisée pour représenter une valeur non valide.ValidLifetime
Durée maximale, en secondes, pendant laquelle l’entrée de route IP est valide. Une valeur de 0xffffffff est considérée comme infinie.PreferredLifetime
Heure par défaut, en secondes, pendant laquelle l’entrée d’itinéraire IP est valide. Une valeur de 0xffffffff est considérée comme infinie.Mesure
Valeur de décalage de la métrique d’itinéraire pour cette entrée d’itinéraire IP. Notez que la métrique d’itinéraire réelle utilisée pour calculer la préférence d’itinéraire est la métrique d’interface spécifiée dans le membre métrique de la structure MIB_IPINTERFACE_ROW ajoutée au décalage de la métrique d’itinéraire qui est spécifié dans ce membre de métrique de métrique . La sémantique de cette métrique est déterminée par le protocole de routage spécifié dans le membre protocole . Si cette métrique n’est pas utilisée, sa valeur doit être définie sur -1. Cette valeur est documentée dans RFC 4292. Pour plus d’informations, consultez MIB de table de transfert IP.Protocole
Le NL_ROUTE_PROTOCOL type de mécanisme de routage avec lequel cette route IP a été ajoutée.Loopback
Valeur qui spécifie si l’itinéraire est un itinéraire de bouclage (la passerelle se trouve sur l’hôte local).AutoconfigureAddress
Valeur qui spécifie si l’adresse IP est configurée automatiquement.Publier
Valeur qui spécifie si l’itinéraire est publié.Immortel
Valeur qui spécifie si la route est immortelle.Age
Nombre de secondes depuis l’ajout ou la modification de l’itinéraire dans la table de routage réseau.Origine
Type d’origine d’itinéraire IP NL_ROUTE_ORIGIN .
Notes
La fonction GetIpForwardTable2 énumère les entrées d’itinéraire IP sur un ordinateur local et retourne ces informations dans une structure de MIB_IPFORWARD_TABLE2 sous forme de tableau d’entrées MIB_IPFORWARD_ROW2.
La fonction GetIpForwardEntry2 récupère une seule entrée de route IP et retourne ces informations dans une structure de MIB_IPFORWARD_ROW2.
Une entrée avec les membres Prefix et PrefixLength de IP_ADDRESS_PREFIX défini sur zéro dans le membre DestinationPrefix de la structure MIB_IPFORWARD_ROW2 est considérée comme un itinéraire par défaut. Le MIB_IPFORWARD_TABLE2 peut contenir plusieurs entrées MIB_IPFORWARD_ROW2 avec les membres Prefix et PrefixLength du IP_ADDRESS_PREFIX définis sur zéro dans le membre DestinationPrefix quand plusieurs cartes réseau sont installées.
Le membre métrique d’une entrée MIB_IPFORWARD_ROW2 est une valeur affectée à une route IP pour une interface réseau particulière qui identifie le coût associé à l’utilisation de cette route. Par exemple, la métrique peut être évaluée en termes de vitesse de liaison, de nombre de tronçons ou de délai. La métrique automatique est une fonctionnalité de Windows XP et des versions ultérieures des systèmes d’exploitation Windows qui configure automatiquement la métrique pour les itinéraires locaux basés sur la vitesse de liaison. Par défaut, la fonctionnalité de métrique automatique est activée (le membre UseAutomaticMetric de la structure MIB_IPINTERFACE_ROW est défini sur TRUE) sur Windows XP et versions ultérieures. Vous pouvez également configurer manuellement cette fonctionnalité pour affecter une métrique spécifique à une route IP.
La métrique d’itinéraire spécifiée dans le membre metric de la structure MIB_IPFORWARD_ROW2 représente uniquement le décalage de la métrique d’itinéraire. La métrique complète est une combinaison de ce décalage de métrique de routage ajouté à la métrique d’interface spécifiée dans le membre metric de la structure MIB_IPINTERFACE_ROW de l’interface associée. Un pilote peut récupérer la métrique d’interface en appelant la fonction GetIpInterfaceEntry .
Spécifications
Version |
Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |