GetIfTable2 函数

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

语法

NETIOAPI_API GetIfTable2(
  _Out_ PMIB_IF_TABLE2 *Table
);

参数

  • [out]
    指向接收 MIB_IF_TABLE2 结构中的接口表的缓冲区的指针。

返回值

GetIfTable2 如果函数成功,则返回STATUS_SUCCESS。

如果函数失败,GetIfTable2 返回以下错误代码之一:

返回代码 描述
STATUS_NOT_ENOUGH_MEMORY

内存资源不足,无法完成作。

其他

使用 FormatMessage 函数获取返回的错误的消息字符串。

言论

GetIfTable2 函数枚举本地计算机上的逻辑接口和物理接口,并在 MIB_IF_TABLE2 结构中返回此信息。

驱动程序可以使用类似的函数(GetIfTable2Ex)指定要返回的接口级别。 对 GetIfTable2Ex 函数的调用,Level 参数设置为 MibIfTableNormal 检索与调用 GetIfTable2 函数相同的结果。

GetIfTable2 返回缓冲区中 参数指向的MIB_IF_TABLE2结构中的接口。 MIB_IF_TABLE2结构包含接口计数和每个接口 MIB_IF_ROW2 结构的数组。 GetIfTable2 为此结构中的MIB_IF_TABLE2结构和MIB_IF_ROW2条目分配内存。 不再需要这些返回的结构时,驱动程序应通过调用 FreeMibTable来释放内存。

请注意,返回的MIB_IF_TABLE2结构,Table 参数指向的可能包含 NumEntries 成员与MIB_IF_TABLE2结构的 Table 成员中的第一个MIB_IF_ROW2数组项之间的填充。 对齐方式的填充也可能存在于MIB_IF_ROW2数组条目之间。 对MIB_IF_ROW2数组条目的任何访问都应假定填充可能存在。

要求

目标平台

通用

版本

在 Windows Vista 和更高版本的 Windows作系统中可用。

页眉

Netioapi.h (包括 Netioapi.h)

图书馆

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

FreeMibTable

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2