struktura MIB_IPFORWARD_ROW2

Článek
2025-03-13

Struktura MIB_IPFORWARD_ROW2 ukládá informace o položce trasy PROTOKOLU IP.

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;

Členové

InterfaceLuid
Místně jedinečný identifikátor (LUID) pro síťové rozhraní přidružené k této položce směrování IP.
InterfaceIndex
Hodnota místního indexu pro síťové rozhraní, které je přidružené k této položce trasy PROTOKOLU IP. Tato hodnota indexu se může změnit, když je síťový adaptér zakázaný a povolený nebo za jiných okolností a neměl by být považován za trvalý.
DestinationPrefix
Předpona IP adresy pro cílovou IP adresu pro tuto trasu.
nextHop
U vzdálené trasy je IP adresa dalšího systému nebo brány, která je na trase. Pokud je trasa na místní adresu zpětné smyčky nebo IP adresa na místním odkazu, další segment směrování není zadaný (všechny nuly). Pro trasu zpětné smyčky místní smyčky by měl být tento člen adresa IPv4 0.0.0 pro položku trasy IPv4 nebo adresu IPv6 0::0 pro položku trasy IPv6.
SitePrefixLength
Délka předpony lokality nebo síťové části IP adresy pro tuto trasu v bitech. U položky trasy IPv4 je jakákoli hodnota větší než 32 neplatná hodnota. U položky trasy IPv6 je jakákoli hodnota větší než 128 neplatná hodnota. Hodnota 255 se obvykle používá k reprezentaci neplatné hodnoty.
ValidLifetime
Maximální doba v sekundách, po kterou je položka trasy PROTOKOLU IP platná. Hodnota 0xffffffff je považována za neomezenou.
PreferredLifetime
Upřednostňovaný čas v sekundách, kdy je položka trasy PROTOKOLU IP platná. Hodnota 0xffffffff je považována za neomezenou.
metriky
Hodnota posunu metriky trasy pro tuto položku trasy IP. Všimněte si skutečné metriky trasy, která se používá k výpočtu předvolby trasy, je metrika rozhraní zadaná v metriky člen struktury MIB_IPINTERFACE_ROW přidaná do posunu metriky trasy zadané v tomto Metric člen. Sémantika této metriky je určena směrovacím protokolem zadaným v protokolu členu. Pokud se tato metrika nepoužívá, měla by být její hodnota nastavená na hodnotu -1. Tato hodnota je zdokumentovaná v dokumentu RFC 4292. Další informace naleznete v tématu TABULKA PŘEDÁVÁNÍ IP MIB.
protokolu
Typ mechanismu směrování NL_ROUTE_PROTOCOL, ke kterému byla tato trasa IP přidána.
zpětné smyčky
Hodnota, která určuje, jestli je trasa trasou zpětné smyčky (brána je na místním hostiteli).
autoconfigureAddress
Hodnota, která určuje, jestli je IP adresa automaticky nakonfigurovaná.
publikovat
Hodnota, která určuje, jestli je trasa publikovaná.
nesmrtelné
Hodnota, která určuje, jestli je trasa nesmrtelná.
věk
Počet sekund od přidání nebo změny trasy v tabulce směrování sítě.
původu
Typ původu trasy protokolu IP NL_ROUTE_ORIGIN.

Poznámky

Funkce GetIpForwardTable2 vytvoří výčet položek směrování PROTOKOLU IP v místním počítači a vrátí tyto informace v MIB_IPFORWARD_TABLE2 struktuře jako pole položek MIB_IPFORWARD_ROW2.

Funkce GetIpForwardEntry2 načte jednu položku trasy PROTOKOLU IP a vrátí tyto informace ve struktuře MIB_IPFORWARD_ROW2.

Položka s předponou a předponou členy IP_ADDRESS_PREFIX nastavenou na nulu ve DestinationPrefix člen ve struktuře MIB_IPFORWARD_ROW2 se považuje za výchozí trasu. MIB_IPFORWARD_TABLE2 může obsahovat více položek MIB_IPFORWARD_ROW2 s předponou a členy PrefixLength IP_ADDRESS_PREFIX nastavenou na nulu v DestinationPrefix člen, pokud je nainstalováno více síťových adaptérů.

Metrika člena položky MIB_IPFORWARD_ROW2 je hodnota, která je přiřazená ke směrování IP pro konkrétní síťové rozhraní, které identifikuje náklady spojené s používáním této trasy. Metriku lze například ohodnotit rychlostí propojení, počtem směrování nebo časovým zpožděním. Automatická metrika je funkce systému Windows XP a novějších verzí operačních systémů Windows, která automaticky konfiguruje metriku pro místní trasy založené na rychlosti propojení. Ve výchozím nastavení je povolena funkce automatické metriky (UseAutomaticMetric člen struktury MIB_IPINTERFACE_ROW je nastaven na TRUE) v systému Windows XP a novější. Tuto funkci můžete také ručně nakonfigurovat tak, aby přiřadil konkrétní metriku ke směrování PROTOKOLU IP.

Metrika trasy zadaná v Metric člen struktury MIB_IPFORWARD_ROW2 představuje pouze posun metriky trasy. Úplná metrika je kombinací tohoto posunu metriky trasy přidané do metriky rozhraní zadané v metriky člen MIB_IPINTERFACE_ROW struktury přidruženého rozhraní. Ovladač může načíst metriku rozhraní voláním funkce GetIpInterfaceEntry.