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 |