initializeIpForwardEntry 函数 (netioapi.h)

InitializeIpForwardEntry 函数使用本地计算机上的 IP 路由条目的默认值初始化MIB_IPFORWARD_ROW2结构。

语法

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

参数

[out] Row

在条目上,指向 IP 路由条目 MIB_IPFORWARD_ROW2 结构条目的指针。 返回时,此参数指向 的MIB_IPFORWARD_ROW2 结构使用 IP 路由条目的默认值进行初始化。

返回值

此函数不返回值。

注解

InitializeIpForwardEntry 函数在 Windows Vista 及更高版本上定义。

InitializeIpForwardEntry 函数必须用于使用 IP 路由条目的默认值初始化MIB_IPFORWARD_ROW2结构条目的成员,以便以后与 CreateIpForwardEntry2 函数一起使用。

输入时,必须向 InitializeIpForwardEntry 传递一个新的 MIB_IPFORWARD_ROW2 结构才能初始化。

输出时,Row 参数指向的 MIB_IPFORWARD_ROW2 结构的 ValidLifetimePreferredLifetime 成员将初始化为 infinite,并且 LoopbackAutoconfigureAddressPublishImmortal 成员将初始化为 TRUE。 此外, SitePrefixLengthMetricProtocol 成员设置为非法值,其他字段初始化为零。

调用 InitializeIpForwardEntry 后,应用程序可以更改要修改 的MIB_IPFORWARD_ROW2 条目中的成员,然后调用 CreateIpForwardEntry2 以将新的 IP 路由条目添加到本地计算机。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netioapi.h (包括 Iphlpapi.h)
Library Iphlpapi.lib
DLL Iphlpapi.dll

另请参阅

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2