MIB_IPFORWARD_ROW2结构

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 路由条目，此成员应为 0.0.0.0 的 IPv4 地址，对于 IPv6 路由条目，该地址应为 0：0。
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 地址。
发布
一个值，该值指定是否发布路由。
不朽的
一个值，该值指定路由是否不朽。
年龄
在网络路由表中添加或修改路由以来的秒数。
源
NL_ROUTE_ORIGIN IP 路由源类型。

言论

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

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

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

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

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