MIB_IPFORWARD_ROW2结构

项目
06/15/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.0，或 IPv6 地址地址为 0：：0用于 IPv6 路由条目。
SitePrefixLength
此路由的 IP 地址的站点前缀或网络部分的长度（以位为单位）。对于 IPv4 路由条目，大于 32 的任何值都是非法值。对于 IPv6 路由条目，任何大于 128 的值都是非法值。值 255 通常用于表示非法值。
ValidLifetime
IP 路由条目有效的最长时间（以秒为单位）。 0xffffffff 值被视为无限。
PreferredLifetime
IP 路由条目有效的首选时间（以秒为单位）。 0xffffffff 值被视为无限。
指标
此 IP 路由条目的路由指标偏移值。请注意，用于计算路由首选项的实际路由指标是在添加到此 Metric 成员中指定的路由指标偏移量的 MIB_IPINTERFACE_ROW 结构的 Metric 成员中指定的接口指标。此指标的语义由 Protocol 成员中指定的路由协议决定。如果未使用此指标，其值应设置为 -1。 RFC 4292 中记录了此值。有关详细信息，请参阅 IP 转发表 MIB。
协议
添加此 IP 路由时使用的 NL_ROUTE_PROTOCOL 路由机制类型。
Loopback
一个值，该值指定路由是否为环回路由， (网关位于本地主机上) 。
AutoconfigureAddress
一个值，该值指定是否自动配置 IP 地址。
发布
一个值，该值指定是否发布路由。
不朽
一个值，该值指定路由是否不朽。
年龄
在网络路由表中添加或修改路由后的秒数。
源
NL_ROUTE_ORIGIN IP 路由源类型。

注解

GetIpForwardTable2 函数枚举本地计算机上的 IP 路由条目，并在MIB_IPFORWARD_TABLE2结构中以MIB_IPFORWARD_ROW2条目数组的形式返回此信息。

GetIpForwardEntry2 函数检索单个 IP 路由条目，并在MIB_IPFORWARD_ROW2结构中返回此信息。

在 MIB_IPFORWARD_ROW2 结构中的 DestinationPrefix 成员中，IP_ADDRESS_PREFIX的 Prefix 和 PrefixLength 成员设置为零的条目被视为默认路由。 MIB_IPFORWARD_TABLE2可能包含多个MIB_IPFORWARD_ROW2条目，当安装了多个网络适配器时，IP_ADDRESS_PREFIX DestinationPrefix 成员中的 Prefix 和 PrefixLength 成员设置为零。

MIB_IPFORWARD_ROW2条目的 Metric 成员是分配给特定网络接口的 IP 路由的值，用于标识与使用该路由关联的成本。例如，可以根据链接速度、跃点计数或时间延迟来评估指标。自动指标是 Windows XP 及更高版本的 Windows 操作系统上的一项功能，可自动为基于链接速度的本地路由配置指标。默认情况下， (Windows XP 及更高版本上将 MIB_IPINTERFACE_ROW 结构的 UseAutomaticMetric 成员设置为 TRUE) ，则启用自动指标功能。还可以手动配置此功能，以将特定指标分配给 IP 路由。

在 MIB_IPFORWARD_ROW2 结构的 Metric 成员中指定的路由指标仅表示路由指标偏移量。完整指标是添加到关联接口的MIB_IPINTERFACE_ROW结构的指标成员中指定的接口指标的路由指标偏移量的组合。驱动程序可以通过调用 GetIpInterfaceEntry 函数来检索接口指标。