InitializeIpForwardEntry 函数

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

语法

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

参数

  • [out]
    在条目上,指向 IP 路由条目 MIB_IPFORWARD_ROW2 结构条目的指针。

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

返回值

备注

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

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

输出时, Row 参数指向的 MIB_IPFORWARD_ROW2 结构的成员将按如下方式初始化。

  • ValidLifetimePreferredLifetime
    设置为无限值,

  • LoopbackAutoconfigureAddressPublishImmortal
    设置为 TRUE

  • SitePrefixLength指标协议
    设置为非法值。

  • 所有其他成员
    设置为零。

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

要求

目标平台

通用

版本

在 Windows Vista 和更高版本的 Windows 操作系统中可用。

标头

Netioapi.h (包括 Netioapi.h)

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2