InitializeUnicastIpAddressEntry 函式 (netioapi.h)

發行項
02/29/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)
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll