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) |
程式庫 | Iphlpapi.lib |
Dll | Iphlpapi.dll |