共用方式為


InitializeIpInterfaceEntry 函式

InitializeIpInterfaceEntry函式會使用預設值,初始化MIB_IPINTERFACE_ROW結構專案的成員。

語法

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

參數

  • 資料列 [in, out]
    要初始化之MIB_IPINTERFACE_ROW結構的指標。 成功傳回時,此參數中的欄位會使用本機電腦上介面的預設資訊初始化。

傳回值

如果函式成功,InitializeIpInterfaceEntry會傳回STATUS_SUCCESS。

如果函式失敗, InitializeIpInterfaceEntry 會傳回下列其中一個錯誤碼:

傳回碼 描述
STATUS_INVALID_PARAMETER

不正確參數已傳遞至 函式。 如果在Row參數中傳遞Null指標,就會傳回此錯誤

其他

使用 FormatMessage 函式來取得傳回錯誤的訊息字串。

備註

輸出時,Row參數所指向之MIB_IPINTERFACE_ROW結構的成員會初始化如下。

  • 系列
    設定為 AF_UNSPEC。

  • InterfaceLuid
    設定為未指定的值。

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

您的驅動程式必須使用 InitializeIpInterfaceEntry 函式,以預設值初始化MIB_IPINTERFACE_ROW結構專案的欄位。 驅動程式接著可以變更MIB_IPINTERFACE_ROW專案中想要修改的欄位,然後呼叫 SetIpInterfaceEntry 函式。

規格需求

目標平台

普遍

版本

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

標頭

Netioapi.h (包含 Netioapi.h)

程式庫

Netio.lib

IRQL

< DISPATCH_LEVEL

另請參閱

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry