Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 d’itinéraire IP.InterfaceIndex
Valeur d’index local de l’interface réseau associée à cette entrée d’itinéraire 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 cette route.NextHop
Pour un itinéraire distant, adresse IP du système ou de la passerelle suivant 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 d’itinéraire IPv4 ou une adresse d’adresse IPv6 de 0 ::0 pour une entrée d’itinéraire IPv6.SitePrefixLength
Longueur, en bits, du préfixe de site ou de la partie réseau de l’adresse IP de cette route. Pour une entrée de routage IPv4, toute valeur supérieure à 32 est une valeur illégale. Pour une entrée de routage IPv6, toute valeur supérieure à 128 est une valeur illégale. La valeur 255 est généralement utilisée pour représenter une valeur illégale.ValidLifetime
Durée maximale, en secondes, pendant laquelle l’entrée d’itinéraire IP est valide. Une valeur de 0xffffffff est considérée comme infinie.PreferredLifetime
Heure préférée, en secondes, pendant laquelle l’entrée d’itinéraire IP est valide. Une valeur de 0xffffffff est considérée comme infinie.de métrique
Valeur de décalage de 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 metric de la structure MIB_IPINTERFACE_ROW ajoutée au décalage de métrique de routage spécifié dans ce membre Metric. 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 table de transfert IP MIB.protocole
Type de mécanisme de routage NL_ROUTE_PROTOCOL avec lequel cette route IP a été ajoutée.de bouclage
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 l’itinéraire est immortel.âge
Nombre de secondes depuis l’ajout ou la modification de l’itinéraire dans la table de routage réseau.d’origine
Type d’origine d’itinéraire IP NL_ROUTE_ORIGIN.
Remarques
La fonction GetIpForwardTable2 énumère les entrées d’itinéraire IP sur un ordinateur local et retourne ces informations dans une structure MIB_IPFORWARD_TABLE2 sous la forme d’un tableau d’entrées MIB_IPFORWARD_ROW2.
La fonction GetIpForwardEntry2 récupère une seule entrée d’itinéraire IP et retourne ces informations dans une structure MIB_IPFORWARD_ROW2.
Une entrée avec le préfixe et les membres PrefixLength de IP_ADDRESS_PREFIX défini sur zéro dans le membre DestinationPrefix dans la structure MIB_IPFORWARD_ROW2 est considéré comme un itinéraire par défaut. Le MIB_IPFORWARD_TABLE2 peut contenir plusieurs entrées MIB_IPFORWARD_ROW2 avec le préfixe et les membres PrefixLength du IP_ADDRESS_PREFIX défini sur zéro dans le membre DestinationPrefix lorsqu’il existe plusieurs cartes réseau installées.
La Metric membre d’une entrée de MIB_IPFORWARD_ROW2 est une valeur affectée à un itinéraire IP pour une interface réseau particulière qui identifie le coût associé à l’utilisation de cet itinéraire. Par exemple, la métrique peut être évaluée en termes de vitesse de liaison, de nombre de tronçons ou de retards de temps. 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 à un itinéraire IP.
La métrique d’itinéraire spécifiée dans la Metric membre de la structure MIB_IPFORWARD_ROW2 représente uniquement le décalage de 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.
Exigences
Version |
Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (include Netioapi.h) |