共用方式為


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 成員將會初始化為 IpPrefixOriginUnchangedSuffixOrigin 成員將會初始化為 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

另請參閱

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

IP 協助程式函式參考

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry