struktura MIB_IPFORWARD_ROW2

Struktura MIB_IPFORWARD_ROW2 przechowuje informacje o wpisie trasy IP.

Składnia

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;

Członków

• InterfaceLuid
  Lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego skojarzonego z tym wpisem trasy IP.

• InterfaceIndex
  Wartość indeksu lokalnego dla interfejsu sieciowego skojarzonego z tym wpisem trasy IP. Ta wartość indeksu może ulec zmianie, gdy karta sieciowa jest wyłączona, a następnie włączona lub w innych okolicznościach i nie powinna być uważana za trwałą.

• DestinationPrefix
  Prefiks adresu IP dla docelowego adresu IP dla tej trasy.

• NextHop
  W przypadku trasy zdalnej adres IP następnego systemu lub bramy, który znajduje się wzdłuż trasy. Jeśli trasa dotyczy lokalnego adresu sprzężenia zwrotnego lub adresu IP w linku lokalnym, następny przeskok jest nieokreślony (wszystkie zera). Dla lokalnej trasy sprzężenia zwrotnego ten element członkowski powinien być adresem IPv4 0.0.0.0 dla wpisu trasy IPv4 lub adresu IPv6 0::0 dla wpisu trasy IPv6.

• SitePrefixLength
  Długość w bitach prefiksu lokacji lub części sieciowej adresu IP dla tej trasy. W przypadku wpisu trasy IPv4 każda wartość większa niż 32 jest niedozwoloną wartością. W przypadku wpisu trasy IPv6 każda wartość większa niż 128 jest niedozwoloną wartością. Wartość 255 jest zwykle używana do reprezentowania niedozwolonej wartości.

• ValidLifetime
  Maksymalny czas w sekundach prawidłowy wpis trasy IP. Wartość 0xffffffff jest uważana za nieskończoną.

• PreferredLifetime
  Preferowany czas (w sekundach), że wpis trasy IP jest prawidłowy. Wartość 0xffffffff jest uważana za nieskończoną.

• Metryka
  Wartość przesunięcia metryki trasy dla tego wpisu trasy IP. Zwróć uwagę, że rzeczywista metryka trasy używana do obliczania preferencji trasy to metryka interfejsu określona w elementu członkowskiego Metryka struktury MIB_IPINTERFACE_ROW dodanej do przesunięcia metryki trasy określonego w tym elemencie członkowskim Metryki. Semantyka tej metryki jest określana przez protokół routingu określony w elemencie protokołu. Jeśli ta metryka nie jest używana, jej wartość powinna być ustawiona na -1. Ta wartość jest udokumentowana w dokumencie RFC 4292. Aby uzyskać więcej informacji, zobacz tabeli przekazywania adresów IP.

• protokołu
  Typ mechanizmu routingu NL_ROUTE_PROTOCOL, za pomocą którego dodano tę trasę IP.

• sprzężenia zwrotnego
  Wartość określająca, czy trasa jest trasą sprzężenia zwrotnego (brama znajduje się na hoście lokalnym).

• autokonfiguracjaaddress
  Wartość określająca, czy adres IP jest automatycznie skonfigurowany.

• publikowanie
  Wartość określająca, czy trasa jest opublikowana.

• Immortal
  Wartość określająca, czy trasa jest nieśmiertelna.

• wiek
  Liczba sekund od dodania lub zmodyfikowania trasy w tabeli routingu sieciowego.

• Origin
  Typ źródła trasy NL_ROUTE_ORIGIN IP.

Uwagi

Funkcja GetIpForwardTable2 wylicza wpisy tras IP na komputerze lokalnym i zwraca te informacje w strukturze MIB_IPFORWARD_TABLE2 jako tablicę wpisów MIB_IPFORWARD_ROW2.

Funkcja GetIpForwardEntry2 pobiera pojedynczy wpis trasy IP i zwraca te informacje w strukturze MIB_IPFORWARD_ROW2.

Wpis z prefiksem i prefiksem PrefiksLength składowych IP_ADDRESS_PREFIX ustawionym na zero w elemencie DestinationPrefix w strukturze MIB_IPFORWARD_ROW2 jest traktowana jako trasa domyślna. MIB_IPFORWARD_TABLE2 może zawierać wiele wpisów MIB_IPFORWARD_ROW2 z prefiksem i prefiksem Length elementów członkowskich IP_ADDRESS_PREFIX ustawionych na zero w elemencie DestinationPrefix, gdy zainstalowano wiele kart sieciowych.

Element członkowski Metric wpisu MIB_IPFORWARD_ROW2 jest wartością przypisaną do trasy IP dla określonego interfejsu sieciowego, który identyfikuje koszt skojarzony z użyciem tej trasy. Na przykład metryka może być wartościowana pod względem szybkości łącza, liczby przeskoku lub opóźnienia czasu. Metryka automatyczna to funkcja w systemie Windows XP i nowszych wersjach systemów operacyjnych Windows, która automatycznie konfiguruje metrykę dla tras lokalnych opartych na szybkości łącza. Domyślnie funkcja automatycznej metryki jest włączona (UseAutomaticMetric składowej struktury MIB_IPINTERFACE_ROW jest ustawiona na true) w systemie Windows XP i nowszych. Tę funkcję można również skonfigurować ręcznie, aby przypisać określoną metrykę do trasy IP.

Metryka trasy określona w Metryka składowej struktury MIB_IPFORWARD_ROW2 reprezentuje tylko przesunięcie metryki trasy. Metryka kompletna jest kombinacją tego przesunięcia metryki trasy dodanego do metryki interfejsu określonej w elementu członkowskiego Metryka struktury MIB_IPINTERFACE_ROW skojarzonego interfejsu. Sterownik może pobrać metrykę interfejsu, wywołując funkcję GetIpInterfaceEntry.

Wymagania

Zobacz też

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetIpForwardEntry2

GetIpForwardTable2

GetIpInterfaceEntry

IP_ADDRESS_PREFIX

MIB_IPFORWARD_TABLE2

MIB_IPINTERFACE_ROW

NL_ROUTE_ORIGIN

NL_ROUTE_PROTOCOL

SetIpForwardEntry2