getInvertedIfStackTable 函式 (netioapi.h)

GetInvertedIfStackTable 函式會擷取反轉網路介面堆疊數據列專案的數據表,以指定介面堆棧上網路介面的關聯性。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetInvertedIfStackTable(
  [out] PMIB_INVERTEDIFSTACK_TABLE *Table
);

參數

[out] Table

緩衝區的指標,接收 MIB_INVERTEDIFSTACK_TABLE 結構中反轉介面堆棧數據列專案的數據表。

傳回值

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

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

傳回碼 Description
ERROR_INVALID_PARAMETER
無效的參數已傳遞至 函式。 如果在 Table 參數中傳遞 NULL 指標,就會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY
記憶體資源不足,無法完成作業。
ERROR_NOT_FOUND
找不到介面堆疊專案。
其他
使用 FormatMessage 函式來取得傳回錯誤的訊息字串。

備註

GetInvertedIfStackTable 函式是在 Windows Vista 和更新版本上定義。

The
GetInvertedIfStackTable 函式會列舉本機系統上介面堆疊上的實體和邏輯網路介面,並以 MIB_INVERTEDIFSTACK_TABLE 結構中的反轉形式傳回這項資訊。

介面堆疊專案會在 Table 參數指向的緩衝區中傳回MIB_INVERTEDIFSTACK_TABLE結構。 MIB_INVERTEDIFSTACK_TABLE 結構包含介面堆疊專案計數,以及每個介面堆疊專案的MIB_INVERTEDIFSTACK_ROW結構數位。

介面堆疊中介面之間的關聯性是MIB_INVERTEDIFSTACK_ROW結構之 HigherLayerInterfaceIndex 成員中索引的介面緊接在 MIB_INVERTEDIFSTACK_ROW 結構的LowerLayerInterfaceIndex 成員的介面上方。

記憶體是由 GetInvertedIfStackTable 函式配置給 MIB_INVERTEDIFSTACK_TABLE 結構和這個結構中的 MIB_INVERTEDIFSTACK_ROW 專案。 當不再需要這些傳回的結構時,請呼叫 FreeMibTable釋放記憶體。

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

規格需求

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

另請參閱

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry