共用方式為


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
    設定為不合法的值。

  • PreferredLifetimeValidLifetime
    設定為無限值。

  • SkipAsSource
    設定為 FALSE

  • 所有其他成員
    設定為零。

在驅動程式呼叫 InitializeUnicastIpAddressEntry之後,驅動程式就可以變更其想要修改之MIB_UNICASTIPADDRESS_ROW專案中的成員,然後呼叫 CreateUnicastIpAddressEntry ,將新的單播 IP 位址新增至本機電腦。

規格需求

目標平台

普遍

版本

可在 Windows Vista 和更新版本的 Windows 作業系統中使用。

標頭

Netioapi.h (包含 Netioapi.h)

程式庫

Netio.lib

IRQL

< DISPATCH_LEVEL

另請參閱

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry