共用方式為


GetIfTable2 函式 (netioapi.h)

GetIfTable2 函式會擷取 MIB-II 介面數據表。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

參數

[out] Table

緩衝區的指標,可接收 MIB_IF_TABLE2 結構中的介面數據表。

傳回值

如果函式成功,傳回值會NO_ERROR。

如果函式失敗,傳回值就是下列其中一個錯誤碼。

傳回碼 Description
ERROR_NOT_ENOUGH_MEMORY
記憶體資源不足,無法完成作業。
其他
使用 FormatMessage 取得傳回錯誤的訊息字串。

備註

The
GetIfTable2 函式會列舉本機系統上的邏輯和實體介面,並在 MIB_IF_TABLE2 結構中傳回這項資訊。 GetIfTable2GetIfTable 函式的增強版本。

類似的 GetIfTable2Ex 函式可用來指定要傳回的介面層級。 呼叫 GetIfTable2Ex 函式, 並將 Level 參數設定為 MibIfTableNormal 會擷取與呼叫 GetIfTable2 函式相同的結果。

介面會在 Table 參數所指向緩衝區的MIB_IF_TABLE2結構中傳回。 MIB_IF_TABLE2 結構包含介面計數,以及每個介面MIB_IF_ROW2結構的陣列。 記憶體是由 GetIfTable2 函式配置給 MIB_IF_TABLE2 結構和這個結構中的MIB_IF_ROW2專案。 不再需要這些傳回的結構時,呼叫 FreeMibTable以釋放記憶體。

請注意,Table 參數所指向的傳回MIB_IF_TABLE2結構可能包含 NumEntries 成員與 MIB_IF_TABLE2 結構之 Table 成員中第一個MIB_IF_ROW2數位專案的填補。 對齊的填補也可能出現在 MIB_IF_ROW2 數位項目之間。 任何對數位專案 MIB_IF_ROW2 的存取都應該假設可能存在填補。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netioapi.h (包括 Iphlpapi.h)
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

FreeMibTable

GetIfTable

GetIfTable2Ex

IP 協助程式函式參考

MIB_IF_ROW2

MIB_IF_TABLE2