initializeUnicastIpAddressEntry 函数 (netioapi.h)
InitializeUnicastIpAddressEntry 函数使用本地计算机上的单播 IP 地址条目的默认值初始化MIB_UNICASTIPADDRESS_ROW结构。
语法
IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
[out] PMIB_UNICASTIPADDRESS_ROW Row
);
参数
[out] Row
输入时,指向单播 IP 地址条目 MIB_UNICASTIPADDRESS_ROW 结构条目的指针。 返回时,此参数指向 的MIB_UNICASTIPADDRESS_ROW 结构使用单播 IP 地址的默认值进行初始化。
返回值
此函数不返回值。
注解
InitializeUnicastIpAddressEntry 函数在 Windows Vista 及更高版本上定义。
InitializeUnicastIpAddressEntry 函数必须用于初始化具有单播 IP 地址默认值的 MIB_UNICASTIPADDRESS_ROW 结构条目的成员,以便以后与 CreateUnicastIpAddressEntry 函数一起使用。
输入时,必须向 InitializeUnicastIpAddressEntry 传递一个新的 MIB_UNICASTIPADDRESS_ROW 结构才能初始化。
输出时,Row 参数 指向的 MIB_UNICASTIPADDRESS_ROW 结构的 PrefixOrigin 成员将初始化为 IpPrefixOriginUnchanged,SuffixOrigin 成员将初始化为 IpSuffixOriginUnchanged,OnLinkPrefixLength 成员将初始化为非法值。 此外, PreferredLifetime 和 ValidLifetime 成员设置为无限期, SkipAsSource 成员设置为 FALSE,其他字段初始化为零。
调用 InitializeUnicastIpAddressEntry 后,应用程序可以更改要修改 的MIB_UNICASTIPADDRESS_ROW 条目中的成员,然后调用 CreateUnicastIpAddressEntry 以将新的单播 IP 地址添加到本地计算机。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | netioapi.h (包括 Iphlpapi.h) |
Library | Iphlpapi.lib |
DLL | Iphlpapi.dll |