getIfStackTable 函式 (netioapi.h)
GetIfStackTable 函式會擷取網路介面堆疊數據列專案的數據表，以指定介面堆疊上網路介面的關聯性。
語法
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfStackTable(
[out] PMIB_IFSTACK_TABLE *Table
);
參數
[out] Table
緩衝區的指標，接收 MIB_IFSTACK_TABLE 結構中介面堆疊數據列專案的數據表。
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 傳回碼 | Description |
|---|---|
|
無效的參數已傳遞至 函式。 如果在 Table 參數中傳遞 NULL 指標，就會傳回此錯誤。 |
|
記憶體資源不足，無法完成作業。 |
|
找不到介面堆疊專案。 |
|
使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
GetIfStackTable 函式是在 Windows Vista 和更新版本上定義。
The
GetIfStackTable 函式會列舉本機系統上介面堆疊上的實體和邏輯網路介面，並在 MIB_IFSTACK_TABLE 結構中傳回這項資訊。
介面堆疊專案會在 Table 參數所指向緩衝區的MIB_IFSTACK_TABLE結構中傳回。 MIB_IFSTACK_TABLE 結構包含介面堆疊專案計數，以及每個介面堆疊專案的MIB_IFSTACK_ROW結構數位。
介面堆疊中介面之間的關聯性是MIB_IFSTACK_ROW結構之 HigherLayerInterfaceIndex 成員中索引的介面緊接在MIB_IFSTACK_ROW結構的 LowerLayerInterfaceIndex 成員中索引的介面上方。
記憶體是由 GetIfStackTable 函式為 MIB_IFSTACK_TABLE 結構和這個結構中的 MIB_IFSTACK_ROW 專案所配置。 當不再需要這些傳回的結構時，請呼叫 FreeMibTable釋放記憶體。
請注意，Table 參數所指向的傳回MIB_IFSTACK_TABLE結構可能包含 NumEntries 成員與MIB_IFSTACK_TABLE結構之 Table 成員中第一個MIB_IFSTACK_ROW數位專案之間的對齊填補。 對齊方式的邊框間距也可能出現在 MIB_IFSTACK_ROW 數位項目之間。 任何對 MIB_IFSTACK_ROW 陣列專案的存取都應該假設填補可能存在。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | netioapi.h (包含 Iphlpapi.h) |
| 程式庫 | Iphlpapi.lib |
| Dll | Iphlpapi.dll |