Freigeben über


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)

Weitere Informationen

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetIpForwardEntry2

GetIpForwardTable2

GetIpInterfaceEntry

IP_ADDRESS_PREFIX

MIB_IPFORWARD_TABLE2

MIB_IPINTERFACE_ROW

NL_ROUTE_ORIGIN

NL_ROUTE_PROTOCOL

SetIpForwardEntry2