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。
如果函数失败，则返回值为以下错误代码之一。
| 返回代码 | 说明 |
|---|---|
|
内存资源不足，无法完成操作。 |
|
使用 FormatMessage 获取返回错误的消息字符串。 |
注解
The
GetIfTable2 函数枚举本地系统上的逻辑和物理接口，并在 MIB_IF_TABLE2 结构中返回此信息。 GetIfTable2 是 GetIfTable 函数的增强版本。
类似的 GetIfTable2Ex 函数可用于指定要返回的接口级别。 调用 Level 参数设置为 MibIfTableNormal 的 GetIfTable2Ex 函数将检索与调用 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) |
| Library | Iphlpapi.lib |
| DLL | Iphlpapi.dll |