InitializeUnicastIpAddressEntry 函式
InitializeUnicastIpAddressEntry函式會使用本機電腦上的單播 IP 位址專案預設值,初始化MIB_UNICASTIPADDRESS_ROW結構。
語法
VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
_Out_ PMIB_UNICASTIPADDRESS_ROW Row
);
參數
- 資料列 [out]
在專案上,單播 IP 位址專案的 MIB_UNICASTIPADDRESS_ROW 結構專案的指標。 傳回時,此參數指向的MIB_UNICASTIPADDRESS_ROW結構會使用單播 IP 位址的預設值初始化。
傳回值
無
備註
您的驅動程式必須使用 InitializeUnicastIpAddressEntry 函式,以單播 IP 位址的預設值初始化 MIB_UNICASTIPADDRESS_ROW 結構專案的成員,以便稍後搭配 CreateUnicastIpAddressEntry 函式使用。
在輸入時,驅動程式必須傳遞 InitializeUnicastIpAddressEntry 新的MIB_UNICASTIPADDRESS_ROW結構,才能初始化。
在輸出時, Row 參數所指向之MIB_UNICASTIPADDRESS_ROW結構的成員會初始化如下。
PrefixOrigin
設定為NL_PREFIX_ORIGIN列舉的IpPrefixOriginUnchanged值。SuffixOrigin
設定為NL_PREFIX_ORIGIN列舉的IpSuffixOriginUnchanged值。OnLinkPrefixLength
設定為不合法的值。PreferredLifetime 和 ValidLifetime
設定為無限值。SkipAsSource
設定為 FALSE。所有其他成員
設定為零。
在驅動程式呼叫 InitializeUnicastIpAddressEntry之後,驅動程式就可以變更其想要修改之MIB_UNICASTIPADDRESS_ROW專案中的成員,然後呼叫 CreateUnicastIpAddressEntry ,將新的單播 IP 位址新增至本機電腦。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |