Freigeben über


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
MIB_IPPROTO_OTHER
1
Der Routingmechanismus wurde nicht angegeben.
MIB_IPPROTO_LOCAL
2
Eine lokale Schnittstelle.
MIB_IPPROTO_NETMGMT
3
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 .
MIB_IPPROTO_ICMP
4
Das Ergebnis einer ICMP-Umleitung.
MIB_IPPROTO_EGP
5
Das Exterior Gateway Protocol (EGP), ein dynamisches Routingprotokoll.
MIB_IPPROTO_GGP
6
Das Gateway-to-Gateway-Protokoll (GGP), ein dynamisches Routingprotokoll.
MIB_IPPROTO_HELLO
7
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.
MIB_IPPROTO_RIP
8
Das Berkeley Routing Information Protocol (RIP) oder RIP-II, ein dynamisches Routingprotokoll.
MIB_IPPROTO_IS_IS
9
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.
MIB_IPPROTO_ES_IS
10
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.
MIB_IPPROTO_CISCO
11
Das Cisco Interior Gateway Routing Protocol (IGRP), ein dynamisches Routingprotokoll.
MIB_IPPROTO_BBN
12
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.
MIB_IPPROTO_OSPF
13
Das OSPF-Protokoll (Open Shortest Path First), ein dynamisches Routingprotokoll.
MIB_IPPROTO_BGP
14
Das Border Gateway Protocol (BGP), ein dynamisches Routingprotokoll.
MIB_IPPROTO_NT_AUTOSTATIC
10002
Ein Windows-spezifischer Eintrag, der ursprünglich von einem Routingprotokoll hinzugefügt wurde, aber jetzt statisch ist.
MIB_IPPROTO_NT_STATIC
10006
Ein Windows-spezifischer Eintrag, der als statische Route von der Routing-Benutzeroberfläche oder einem Routingbefehl hinzugefügt wird.
MIB_IPPROTO_NT_STATIC_NON_DOD
10007
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.

Wert Bedeutung
NlroManual
0
Ein Ergebnis der manuellen Konfiguration.
NlroWellKnown
1
Eine bekannte Route.
NlroDHCP
2
Ein Ergebnis der DHCP-Konfiguration.
NlroRouterAdvertisement
3
Das Ergebnis der Routeranzeige.
Nlro6to4
4
Ein Ergebnis von 6to4-Tunneling.

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)

Weitere Informationen

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetIpForwardEntry2

GetIpForwardTable2

GetIpInterfaceEntry

IP_ADDRESS_PREFIX

MIB_IPFORWARD_TABLE2

MIB_IPINTERFACE_ROW

SOCKADDR_INET

SetIpForwardEntry2