MIB_IPFORWARD_ROW2 結構

發行項
03/08/2023

MIB_IPFORWARD_ROW2結構會儲存 IP 路由專案的相關資訊。

語法

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;

成員

InterfaceLuid
與此 IP 路由專案相關聯的網路介面本機唯一識別碼 (LUID) 。
InterfaceIndex
與此 IP 路由專案相關聯的網路介面本機索引值。當網路介面卡停用後啟用或在其他情況下，此索引值可能會變更，且不應視為持續性。
DestinationPrefix
此路由之目的地 IP 位址的 IP 位址前置詞。
NextHop
如果是遠端路由，則為沿著路由的下一個系統或閘道的 IP 位址。如果路由是本機回送位址或本機連結上的 IP 位址，則下一個躍點未指定 (所有零) 。針對本機回送路由，此成員應該是 IPv4 路由專案的 IPv4 位址 0.0.0 或 IPv6 位址位址 0：：0為 IPv6 路由專案。
SitePrefixLength
此路由之 IP 位址的月臺前置詞或網路部分的長度，以位為單位。針對 IPv4 路由專案，大於 32 的任何值都是不合法的值。對於 IPv6 路由專案，大於 128 的任何值都是不合法的值。值 255 通常用來表示不合法的值。
ValidLifetime
IP 路由專案有效的最大時間，以秒為單位。 0xffffffff的值會被視為無限。
PreferredLifetime
IP 路由專案有效的慣用時間，以秒為單位。 0xffffffff的值會被視為無限。
計量
此 IP 路由專案的路由計量位移值。請注意，用來計算路由喜好設定的實際路由計量是在加入至此計量成員所指定之路由計量位移的計量成員中指定之MIB_IPINTERFACE_ROW結構的介面計量。此計量的語意取決於通訊 協定成員中指定的 路由通訊協定。如果未使用此計量，其值應設定為 -1。此值記載于 RFC 4292 中。如需詳細資訊，請參閱 IP 轉送資料表 MIB。
通訊協定
新增此 IP 路由 的NL_ROUTE_PROTOCOL 路由機制類型。
回送
值，指定路由是否為回送路由， (閘道位於本機主機上) 。
AutoconfigureAddress
值，指定 IP 位址是否已自動設定。
Publish
值，指定是否發佈路由。
不朽
值，指定路由是否為不嚴重。
年齡
在網路路由表中新增或修改路由之後的秒數。
來源
NL_ROUTE_ORIGIN IP 路由來源類型。

備註

GetIpForwardTable2函式會列舉本機電腦上的 IP 路由專案，並在MIB_IPFORWARD_TABLE2結構中傳回這項資訊做為MIB_IPFORWARD_ROW2專案的陣列。

GetIpForwardEntry2函式會擷取單一 IP 路由專案，並在MIB_IPFORWARD_ROW2結構中傳回這項資訊。

在IP_ADDRESS_PREFIX MIB_IPFORWARD_ROW2結構之DestinationPrefix成員中，具有Prefix和PrefixLength成員的專案會被視為預設路由。當安裝多個網路介面卡時，MIB_IPFORWARD_TABLE2可能包含多個具有Prefix和PrefixLength成員之IP_ADDRESS_PREFIX成員的多個MIB_IPFORWARD_ROW2專案。

MIB_IPFORWARD_ROW2專案的計量成員是指派給特定網路介面 IP 路由的值，可識別使用該路由相關聯的成本。例如，計量可以根據連結速度、躍點計數或時間延遲來值。自動計量是 Windows XP 和更新版本的 Windows 作業系統上的功能，可針對以連結速度為基礎的本機路由自動設定計量。根據預設， (windows XP 和更新版本上MIB_IPINTERFACE_ROW結構的 UseAutomaticMetric 成員啟用自動計量功能為 TRUE) 。您也可以手動設定這項功能，以將特定計量指派給 IP 路由。

在 MIB_IPFORWARD_ROW2 結構的 Metric 成員中指定的路由計量只代表路由計量位移。完整的計量是這個路由計量位移的組合，新增至介面計量，該計量是在相關聯介面之MIB_IPINTERFACE_ROW結構的Metric成員中指定的。驅動程式可以藉由呼叫 GetIpInterfaceEntry 函式 來擷取介面計量。