InitializeUnicastIpAddressEntry 函数

InitializeUnicastIpAddressEntry 函数使用本地计算机上的单播 IP 地址条目的默认值初始化 MIB_UNICASTIPADDRESS_ROW 结构。

语法

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

参数

  • [out]
    在条目中,指向单播 IP 地址条目的 MIB_UNICASTIPADDRESS_ROW 结构条目的指针。 返回时,此参数指向的MIB_UNICASTIPADDRESS_ROW结构使用单播 IP 地址的默认值进行初始化。

返回值

没有

言论

驱动程序必须使用 InitializeUnicastIpAddressEntry 函数初始化具有单播 IP 地址默认值的 MIB_UNICASTIPADDRESS_ROW 结构条目的成员,以便稍后与 CreateUnicastIpAddressEntry 函数一起使用。

输入时,驱动程序必须传递 InitializeUnicastIpAddressEntry 新的MIB_UNICASTIPADDRESS_ROW结构进行初始化。

输出时, 参数指向的MIB_UNICASTIPADDRESS_ROW结构的成员将按如下所示进行初始化。

  • PrefixOrigin
    设置为 NL_PREFIX_ORIGIN 枚举的 IpPrefixOriginUnchanged 值。

  • 后缀Origin
    设置为 NL_PREFIX_ORIGIN 枚举的 IpSuffixOriginUnchanged 值。

  • OnLinkPrefixLength
    设置为非法值。

  • PreferredLifetimeValidLifetime
    设置为无限值。

  • SkipAsSource
    设置为 FALSE

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

驱动程序调用 InitializeUnicastIpAddressEntry后,驱动程序可以更改要修改的MIB_UNICASTIPADDRESS_ROW条目中的成员,然后调用 CreateUnicastIpAddressEntry 将新的单播 IP 地址添加到本地计算机。

要求

目标平台

通用

版本

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

页眉

Netioapi.h (包括 Netioapi.h)

图书馆

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry