MIB_IPFORWARD_ROW2 Struktur (netioapi.h)
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
Typ: NET_LUID
Der lokal eindeutige Bezeichner (LUID) für die Netzwerkschnittstelle, die diesem IP-Routeneintrag zugeordnet ist.
InterfaceIndex
Typ: NET_IFINDEX
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 wird, oder unter anderen Umständen, und sollte nicht als persistent betrachtet werden.
DestinationPrefix
Typ: IP_ADDRESS_PREFIX
Das IP-Adresspräfix für die Ziel-IP-Adresse für diese Route.
NextHop
Typ: SOCKADDR_INET
Bei einer Remoteroute die IP-Adresse des nächsten Systems oder Gateways auf der Route. 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 von 0.0.0.0 für einen IPv4-Routeneintrag oder um eine IPv6-Adresse von 0::0 für einen IPv6-Routeneintrag handeln.
SitePrefixLength
Typ: UCHAR
Die Länge des Standortpräfixes oder des Netzwerkteils der IP-Adresse für diese Route in Bits. Für einen IPv4-Routeneintrag ist jeder Wert größer als 32 ein unzulässiger Wert. Bei einem IPv6-Routeneintrag ist jeder Wert größer als 128 ein unzulässiger Wert. Ein Wert von 255 wird häufig verwendet, um einen ungültigen Wert darzustellen.
ValidLifetime
Typ: ULONG
Die maximale Zeit in Sekunden, in der der IP-Routeneintrag gültig ist. Ein Wert von 0xffffffff gilt als unendlich.
PreferredLifetime
Typ: ULONG
Die bevorzugte Zeit in Sekunden, zu der der IP-Routeneintrag gültig ist. Ein Wert von 0xffffffff gilt als unendlich.
Metric
Typ: ULONG
Der Offsetwert der Routenmetrik für diesen IP-Routeneintrag. Beachten Sie, dass die tatsächliche Routenmetrik, die zum Berechnen der Routeneinstellung verwendet wird, die Summe der Schnittstellenmetrik ist, die im Metrikelement der MIB_IPINTERFACE_ROW-Struktur und dem in diesem Element angegebenen Routenmetrikoff 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 http://www.ietf.org/rfc/rfc4292.txt.
Protocol
Typ: NL_ROUTE_PROTOCOL
Der Routingmechanismus, wie diese IP-Route hinzugefügt wurde. Dieser Member kann einer der Werte aus dem NL_ROUTE_PROTOCOL Enumerationstyp sein, der in der Headerdatei Nldef.h definiert ist. Das Element wird in RFC 4292 beschrieben. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc4292.txt.
Beachten Sie, dass der Nldef.h-Header automatisch von der Ipmib.h-Headerdatei eingeschlossen wird, die automatisch vom Iprtrmib.h-Header eingeschlossen wird. Der Iphlpapi.h-Header enthält automatisch die Headerdatei Iprtrmib.h . Die Headerdateien Iprtrmib.h, Ipmib.h und Nldef.h sollten nie direkt verwendet werden.
Die folgende Liste zeigt die möglichen Werte für diesen Member.
| Wert | Bedeutung |
|---|---|
|
Der Routingmechanismus wurde nicht angegeben. |
|
Eine lokale Schnittstelle. |
|
Eine statische Route. Dieser Wert wird verwendet, um Routeninformationen für das IP-Routing zu identifizieren, das über die Netzwerkverwaltung festgelegt wird, z. B. das Dynamic Host Configuration Protocol (DCHP), das Simple Network Management Protocol (SNMP) oder durch Aufrufe der Funktionen CreateIpForwardEntry2, DeleteIpForwardEntry2 oder SetIpForwardEntry2 . |
|
Das Ergebnis einer ICMP-Umleitung. |
|
Das Exterior Gateway Protocol (EGP), ein dynamisches Routingprotokoll. |
|
Das Gateway-to-Gateway-Protokoll (GGP), ein dynamisches Routingprotokoll. |
|
Das Hellospeak-Protokoll, ein dynamisches Routingprotokoll. Dies ist ein historischer Eintrag, der nicht mehr verwendet wird und ein frühes Routingprotokoll war, das von den ursprünglichen ARPANET-Routern verwendet wurde, die spezielle Software namens Fuzzball-Routingprotokoll ausgeführt haben, die manchmal hellospeak genannt wird, wie in RFC 891 und RFC 1305 beschrieben. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc891.txt und http://www.ietf.org/rfc/rfc1305.txt. |
|
Das Berkeley Routing Information Protocol (RIP) oder RIP-II, ein dynamisches Routingprotokoll. |
|
Das IS-Protokoll (Intermediate System-to-Intermediate System), ein dynamisches Routingprotokoll. Das IS-IS-Protokoll wurde für die Verwendung in der OSI-Protokollsuite (Open Systems Interconnection) entwickelt. |
|
Das ES-IS-Protokoll (End System-to-Intermediate System), ein dynamisches Routingprotokoll. Das ES-IS-Protokoll wurde für die Verwendung in der OSI-Protokollsuite (Open Systems Interconnection) entwickelt. |
|
Das Cisco Interior Gateway Routing Protocol (IGRP), ein dynamisches Routingprotokoll. |
|
Das Bolt-, Beranek- und Newman-Interior Gateway-Protokoll (IGP), das den SPF-Algorithmus (Shortest Path First) verwendet hat. Dies war ein frühes dynamisches Routingprotokoll. |
|
Das OSPF-Protokoll (Open Shortest Path First), ein dynamisches Routingprotokoll. |
|
Das Border Gateway Protocol (BGP), ein dynamisches Routingprotokoll. |
|
Ein Windows-spezifischer Eintrag, der ursprünglich von einem Routingprotokoll hinzugefügt wurde, aber jetzt statisch ist. |
|
Ein Windows-spezifischer Eintrag, der als statische Route von der Routing-Benutzeroberfläche oder einem Routingbefehl hinzugefügt wird. |
|
Ein Windows-spezifischer Eintrag, der als statische Route über die Routing-Benutzeroberfläche oder einen Routingbefehl hinzugefügt wurde, mit dem Unterschied, dass diese Routen keine Dial On Demand (DOD) verursachen. |
Loopback
Typ: BOOLEAN
Ein -Wert, der angibt, ob die Route eine Loopbackroute ist (das Gateway befindet sich auf dem lokalen Host).
AutoconfigureAddress
Typ: BOOLEAN
Ein -Wert, der angibt, ob die IP-Adresse automatisch konfiguriert ist.
Publish
Typ: BOOLEAN
Ein -Wert, der angibt, ob die Route veröffentlicht wird.
Immortal
Typ: BOOLEAN
Ein -Wert, der angibt, ob die Route unsterblich ist.
Age
Typ: ULONG
Die Anzahl der Sekunden seit dem Hinzufügen oder Ändern der Route in der Netzwerkroutingtabelle.
Origin
Typ: NL_ROUTE_ORIGIN
Der Ursprung der Route. Dieser Member kann einer der Werte aus dem NL_ROUTE_ORIGIN Enumerationstyp sein, der in der Headerdatei Nldef.h definiert ist.
Hinweise
Die MIB_IPFORWARD_ROW2-Struktur wird unter Windows Vista und höher definiert.
Die GetIpForwardTable2-Funktion listet die IP-Routeneinträge auf einem lokalen System 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 des IP_ADDRESS_PREFIX im DestinationPrefix-Element in der MIB_IPFORWARD_ROW2-Struktur auf 0 festgelegt ist, wird als Standardroute betrachtet. Die MIB_IPFORWARD_TABLE2 kann mehrere MIB_IPFORWARD_ROW2 Einträge enthalten, wobei die Member Prefix und PrefixLength des IP_ADDRESS_PREFIX im DestinationPrefix-Member auf Null festgelegt sind, wenn mehrere Netzwerkadapter installiert sind.
Der Metrikmember eines MIB_IPFORWARD_ROW2 Eintrags ist ein Wert, der einer IP-Route für eine bestimmte Netzwerkschnittstelle zugewiesen wird, die die Kosten identifiziert, die mit der Verwendung dieser Route verbunden sind. Beispielsweise kann die Metrik in Bezug auf Linkgeschwindigkeit, Hopanzahl oder Zeitverzögerung bewertet werden. Die automatische Metrik ist ein Feature unter Windows XP und höher, das automatisch die Metrik für die lokalen Routen konfiguriert, die auf der Verbindungsgeschwindigkeit basieren. Das Feature für automatische Metriken ist unter Windows XP und höher standardmäßig aktiviert (der UseAutomaticMetric-Member der MIB_IPINTERFACE_ROW-Struktur ist auf TRUE festgelegt). Es kann auch manuell konfiguriert werden, um einer IP-Route eine bestimmte Metrik zuzuweisen.
Die im Metrikelement der MIB_IPFORWARD_ROW2-Struktur angegebene Routenmetrik 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 ist. Eine Anwendung kann die Schnittstellenmetrik abrufen, indem sie die GetIpInterfaceEntry-Funktion aufruft .
Beachten Sie, dass die Netioapi.h-Headerdatei automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Netioapi.h-Headerdatei sollte niemals direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | netioapi.h (include Iphlpapi.h) |