MIB_IPFORWARD_ROW2 Struktur
Die MIB_IPFORWARD_ROW2-Struktur speichert Informationen zu einem IP-Routeneintrag.
Syntax
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;
Member
InterfaceLuid
Der lokal eindeutige Bezeichner (LUID) für die Netzwerkschnittstelle, die diesem IP-Routeneintrag zugeordnet ist.InterfaceIndex
Der lokale Indexwert für die Netzwerkschnittstelle, die diesem IP-Routeneintrag zugeordnet ist. Dieser Indexwert kann sich ändern, wenn ein Netzwerkadapter deaktiviert und dann aktiviert ist, oder unter anderen Umständen, und sollte nicht als persistent betrachtet werden.DestinationPrefix
Das IP-Adresspräfix für die Ziel-IP-Adresse für diese Route.NextHop
Bei einer Remoteroute die IP-Adresse des nächsten Systems oder Gateways, das sich entlang der Route befindet. Wenn die Route eine lokale Loopbackadresse oder eine IP-Adresse im lokalen Link ist, wird der nächste Hop nicht angegeben (alle Nullen). Bei einer lokalen Loopbackroute sollte es sich bei diesem Member um eine IPv4-Adresse 0.0.0.0 für einen IPv4-Routeneintrag oder um eine IPv6-Adressadresse von 0::0 handeln. für einen IPv6-Routeneintrag.SitePrefixLength
Die Länge des Standortpräfixes oder des Netzwerkteils der IP-Adresse für diese Route in Bits. Bei einem IPv4-Routeneintrag ist jeder Wert, der größer als 32 ist, ein unzulässiger Wert. Bei einem IPv6-Routeneintrag ist jeder Wert, der größer als 128 ist, ein ungültiger Wert. Ein Wert von 255 wird in der Regel verwendet, um einen ungültigen Wert darzustellen.ValidLifetime
Die maximale Zeit in Sekunden, in der der IP-Routeneintrag gültig ist. Ein Wert von 0xffffffff gilt als unendlich.PreferredLifetime
Die bevorzugte Zeit in Sekunden, zu der der IP-Routeneintrag gültig ist. Ein Wert von 0xffffffff gilt als unendlich.Metrik
Der Offsetwert der Routenmetrik für diesen IP-Routeneintrag. Beachten Sie, dass die tatsächliche Routenmetrik, die zum Berechnen der Routeneinstellung verwendet wird, die im Metrikelement der MIB_IPINTERFACE_ROW-Struktur angegeben ist, die dem Routenmetrikoffsatz hinzugefügt wird, der in diesem Metrikmember angegeben ist. Die Semantik dieser Metrik wird durch das Routingprotokoll bestimmt, das im Protokollelement angegeben ist. Wenn diese Metrik nicht verwendet wird, sollte ihr Wert auf -1 festgelegt werden. Dieser Wert ist in RFC 4292 dokumentiert. Weitere Informationen finden Sie unter IP-Weiterleitungstabelle MIB.Protokoll
Der NL_ROUTE_PROTOCOL Routingmechanismustyp, mit dem diese IP-Route hinzugefügt wurde.Loopback
Ein Wert, der angibt, ob es sich bei der Route um eine Loopbackroute handelt (das Gateway befindet sich auf dem lokalen Host).AutoconfigureAddress
Ein Wert, der angibt, ob die IP-Adresse automatisch konfiguriert ist.Veröffentlichen
Ein Wert, der angibt, ob die Route veröffentlicht wird.Unsterblich
Ein Wert, der angibt, ob die Route unsterblich ist.Alter
Die Anzahl der Sekunden, seit die Route in der Netzwerkroutingtabelle hinzugefügt oder geändert wurde.Ursprung
Ein NL_ROUTE_ORIGIN IP-Routenursprungtyp.
Bemerkungen
Die GetIpForwardTable2-Funktion listet die IP-Routeneinträge auf einem lokalen Computer auf und gibt diese Informationen in einer MIB_IPFORWARD_TABLE2 Struktur als Array von MIB_IPFORWARD_ROW2 Einträgen zurück.
Die GetIpForwardEntry2-Funktion ruft einen einzelnen IP-Routeneintrag ab und gibt diese Informationen in einer MIB_IPFORWARD_ROW2-Struktur zurück.
Ein Eintrag mit dem Prefix - und den PrefixLength-Membern von IP_ADDRESS_PREFIX im DestinationPrefix-Member in der MIB_IPFORWARD_ROW2-Struktur auf Null festgelegt ist, wird als Standardroute betrachtet. Die MIB_IPFORWARD_TABLE2 kann mehrere MIB_IPFORWARD_ROW2-Einträge enthalten, wobei das Prefix und die PrefixLength-Member des IP_ADDRESS_PREFIX im DestinationPrefix-Member auf Null festgelegt sind, wenn mehrere Netzwerkadapter installiert sind.
Das Metrikmember eines MIB_IPFORWARD_ROW2-Eintrags ist ein Wert, der einer IP-Route für eine bestimmte Netzwerkschnittstelle zugewiesen ist, die die Kosten identifiziert, die mit der Verwendung dieser Route verbunden sind. Die Metrik kann beispielsweise in Bezug auf Linkgeschwindigkeit, Hopanzahl oder Zeitverzögerung geschätzt werden. Die automatische Metrik ist ein Feature unter Windows XP und höheren Versionen der Windows-Betriebssysteme, das die Metrik automatisch für die lokalen Routen konfiguriert, die auf der Verbindungsgeschwindigkeit basieren. Standardmäßig ist das Feature für automatische Metriken aktiviert (der UseAutomaticMetric-Member der MIB_IPINTERFACE_ROW-Struktur ist unter Windows XP und höher auf TRUE festgelegt. Sie können dieses Feature auch manuell konfigurieren, um einer IP-Route eine bestimmte Metrik zuzuweisen.
Die Routenmetrik, die im Metrikelement der MIB_IPFORWARD_ROW2-Struktur angegeben ist, stellt nur den Routenmetrikoffset dar. Die vollständige Metrik ist eine Kombination aus diesem Routenmetrikoffset, der der Schnittstellenmetrik hinzugefügt wird, die im Metrikelement der MIB_IPINTERFACE_ROW Struktur der zugeordneten Schnittstelle angegeben wird. Ein Treiber kann die Schnittstellenmetrik abrufen, indem er die GetIpInterfaceEntry-Funktion aufruft .
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (einschließlich Netioapi.h) |