共用方式為


GetInvertedIfStackTable 函式

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

語法

NETIOAPI_API GetInvertedIfStackTable(
  _Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);

參數

  • 數據表 [out]
    緩衝區的指標,這個緩衝區會接收 MIB_INVERTEDIFSTACK_TABLE 結構中反向介面堆疊數據列專案的數據表。

傳回值

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

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

傳回碼 描述
STATUS_INVALID_PARAMETER

無效的參數已傳遞至函式。 如果在 table 參數 中傳遞 NULL 指標,就會傳回此錯誤。

STATUS_NOT_ENOUGH_MEMORY

記憶體資源不足,無法完成作業。

STATUS_NOT_FOUND

找不到介面堆疊專案。

其他

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

言論

GetInvertedIfStackTable 函式會列舉本機電腦上介面堆疊上的實體和邏輯網路介面,並以反向形式傳回 MIB_INVERTEDIFSTACK_TABLE 結構中的資訊。

GetInvertedIfStackTable 傳回緩衝區中 Table 參數指向的MIB_INVERTEDIFSTACK_TABLE結構中的介面堆棧專案。 MIB_INVERTEDIFSTACK_TABLE 結構包含介面堆疊專案計數,以及每個介面堆疊專案之 MIB_INVERTEDIFSTACK_ROW 結構的陣列。

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

GetInvertedIfStackTable 配置記憶體給MIB_INVERTEDIFSTACK_TABLE結構和這個結構中的MIB_INVERTEDIFSTACK_ROW專案。 當不再需要這些傳回的結構時,您的驅動程式應該呼叫freeMibTable 來釋放記憶體。

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

要求

目標平臺

通用

版本

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

頁眉

Netioapi.h (包括 Netioapi.h)

圖書館

Netio.lib

IRQL

< DISPATCH_LEVEL

另請參閱

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry