GetInvertedIfStackTable 函数

GetInvertedIfStackTable 函数检索一个反向网络接口堆栈行项表,该表指定接口堆栈上的网络接口的关系。

语法

NETIOAPI_API GetInvertedIfStackTable(
  _Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);

参数

返回值

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

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

返回代码 描述
STATUS_INVALID_PARAMETER

将无效参数传递给函数。 如果在 Table 参数中传递 NULL 指针,则返回此错误。

STATUS_NOT_ENOUGH_MEMORY

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

STATUS_NOT_FOUND

未找到接口堆栈条目。

其他

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

言论

GetInvertedIfStackTable 函数枚举本地计算机上的接口堆栈上的物理和逻辑网络接口,并在 MIB_INVERTEDIFSTACK_TABLE 结构中以倒转形式返回此信息。

GetInvertedIfStackTable 返回缓冲区中 参数指向的MIB_INVERTEDIFSTACK_TABLE结构中的接口堆栈条目。 MIB_INVERTEDIFSTACK_TABLE结构包含接口堆栈条目计数和每个接口堆栈条目的 MIB_INVERTEDIFSTACK_ROW 结构数组。

接口堆栈中的接口之间的关系是,MIB_INVERTEDIFSTACK_ROW结构的 HigherLayerInterfaceIndex 成员中具有索引的接口紧接在 LowerLayerInterfaceIndex MIB_INVERTEDIFSTACK_ROW 成员的接口之上。

GetInvertedIfStackTable 为此结构中的MIB_INVERTEDIFSTACK_TABLE结构和MIB_INVERTEDIFSTACK_ROW条目分配内存。 不再需要这些返回的结构时,驱动程序应通过调用 FreeMibTable来释放内存。

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

要求

目标平台

通用

版本

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

页眉

Netioapi.h (包括 Netioapi.h)

图书馆

Netio.lib

IRQL

< DISPATCH_LEVEL

另请参阅

FreeMibTable

GetIfEntry2

GetIfStackTable

GetIfTable2

GetIpInterfaceEntry

InitializeIpInterfaceEntry

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange

SetIpInterfaceEntry