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结构来初始化。
在输出中， Row 参数指向的 MIB_UNICASTIPADDRESS_ROW 结构的成员将按如下方式初始化。
PrefixOrigin
设置为 NL_PREFIX_ORIGIN 枚举的 IpPrefixOriginUnchanged 值。SuffixOrigin
设置为 NL_PREFIX_ORIGIN 枚举的 IpSuffixOriginUnchanged 值。OnLinkPrefixLength
设置为非法值。PreferredLifetime 和 ValidLifetime
设置为无限值。SkipAsSource
设置为 FALSE。所有其他成员
设置为零。
在驱动程序调用 InitializeUnicastIpAddressEntry 之后，驱动程序可以更改要修改的MIB_UNICASTIPADDRESS_ROW条目中的成员，然后调用 CreateUnicastIpAddressEntry 以将新的单播 IP 地址添加到本地计算机。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
标头 |
Netioapi.h (包括 Netioapi.h) |
库 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |