initializeUnicastIpAddressEntry 函数 (netioapi.h)

项目
03/05/2024

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