getIfTable2 函数 (netioapi.h)

项目
02/29/2024

GetIfTable2 函数检索 MIB-II 接口表。

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfTable2(
  [out] PMIB_IF_TABLE2 *Table
);

参数

[out] Table

指向缓冲区的指针，该缓冲区接收 MIB_IF_TABLE2 结构中的接口表。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

返回代码	说明
ERROR_NOT_ENOUGH_MEMORY	内存资源不足，无法完成操作。
其他	使用 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