GetIpInterfaceTable 函式
GetIpInterfaceTable函式會擷取本機電腦上的 IP 介面專案。
語法
NETIOAPI_API GetIpInterfaceTable(
_In_ ADDRESS_FAMILY Family,
_Out_ PMIB_IPINTERFACE_TABLE *Table
);
參數
家庭 [in]
要擷取的 IP 介面位址系列。位址系列的可能值會列在 Winsock2.h 標頭檔中。 請注意，AF_位址系列和PF_通訊協定系列常數的值 (相同，例如AF_INET和PF_INET) ，因此您可以使用任一常數。
在 Windows Vista 和更新版本的 Windows 作業系統上， Family 參數的可能值定義在 Ws2def.h 標頭檔中。 請注意，Ws2def.h 標頭檔會自動包含在 Netioapi.h 中，您不應該直接使用 Ws2def.h。
位址系列目前支援下列值：
AF_INET
IPv4 位址系列。AF_INET6
IPv6 位址系列。AF_UNSPEC
未指定位址系列。 指定此值時， GetIpInterfaceTable 函式會傳回同時包含 IPv4 和 IPv6 專案的 IP 介面資料表。
資料表 [out]
緩衝區的指標，接收 MIB_IPINTERFACE_TABLE 結構中的 IP 介面專案資料表。
傳回值
如果函式成功，GetIpInterfaceTable會傳回STATUS_SUCCESS。
如果函式失敗， GetIpInterfaceTable 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 不正確參數已傳遞至 函式。 如果在Table參數中傳遞Null指標，或Family參數未指定為 AF_INET、AF_INET6 或 AF_UNSPEC，則會傳回此錯誤。 |
| STATUS_NOT_ENOUGH_MEMORY | 記憶體資源不足，無法完成作業。 |
| STATUS_NOT_FOUND | 找不到 Family 參數中指定的 IP 介面專案。 |
| STATUS_NOT_SUPPORTED | 不支援函式。 如果未在本機電腦上設定 Address 參數中指定的 IP 傳輸，就會傳回此錯誤。 這個錯誤也會在不支援此函式的 Windows 版本上傳回。 |
| 其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
GetIpInterfaceTable函式會列舉本機電腦上的 IP 介面，並在MIB_IPINTERFACE_TABLE結構中傳回這項資訊。
GetIpInterfaceTable 會在 Table 參數指向的緩衝區中，傳回MIB_IPINTERFACE_TABLE結構中的 IP 介面專案。 MIB_IPINTERFACE_TABLE 結構包含 IP 介面專案計數，以及每個 IP 介面專案的 MIB_IPINTERFACE_ROW 結構陣列。 當不再需要這些傳回的結構時，您的驅動程式應該呼叫 FreeMibTable 函式來釋放記憶體。
您的驅動程式必須將 Family 參數初始化為 AF_INET 或 AF_INET6。
請注意，Table參數指向的傳回MIB_IPINTERFACE_TABLE結構可能包含NumEntries成員與MIB_IPINTERFACE_TABLE結構之Table成員中第一個MIB_IPINTERFACE_ROW陣列專案之間的對齊填補。 對齊方式的邊框間距也可能出現在MIB_IPINTERFACE_ROW陣列專案之間。 任何對MIB_IPINTERFACE_ROW陣列專案的存取都應該假設填補可能存在。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |