getIfEntry2Ex 函数 (netioapi.h)

GetIfEntry2Ex 函数检索本地计算机上指定接口的指定信息级别。

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIfEntry2Ex(
  [in]      MIB_IF_ENTRY_LEVEL Level,
  [in, out] PMIB_IF_ROW2       Row
);

[in] Level

要检索的接口信息的级别。此参数可以是 Netioapi.h 头文件中定义的 MIB_IF_ENTRY_LEVEL 枚举类型的值之一。

值	含义
MibIfEntryNormal 0	Row 参数指向的 MIB_IF_ROW2 结构成员中返回的统计信息值和状态值从筛选器堆栈顶部返回。
MibIfEntryNormalWithoutStatistics 2	在 Row 参数指向的 MIB_IF_ROW2 结构成员中返回的状态 ( 值，) 从筛选器堆栈顶部返回。

[in, out] Row

指向 MIB_IF_ROW2 结构的指针，成功返回后，该结构接收本地计算机上的接口信息。输入时，必须将MIB_IF_ROW2的 InterfaceLuid 或 InterfaceIndex 成员设置为要检索其信息的接口。

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

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

返回代码	说明
ERROR_FILE_NOT_FOUND	系统找不到指定的文件。如果由 Row 参数指向的MIB_IF_ROW2的 InterfaceLuid 或 InterfaceIndex 成员指定的网络接口 LUID 或接口索引不是本地计算机上的值，则返回此错误。
ERROR_INVALID_PARAMETER	向该函数传递了无效参数。如果在 Row 参数中传递 NULL 参数，则返回此错误。如果未指定 Row 参数指向的MIB_IF_ROW2的 InterfaceLuid 和 InterfaceIndex 成员，也会返回此错误。
其他	使用 FormatMessage 函数获取返回错误的消息字符串。

The
GetIfEntry2Ex 函数检索本地系统上指定接口的信息，并在指向的指针中返回此信息
MIB_IF_ROW2 结构。 GetIfEntry2Ex 是 GetIfEntry2 函数的增强版本，允许选择要检索的接口信息级别。

输入时，必须初始化在 Row 参数中传递的 MIB_IF_ROW2 结构中至少一个以下成员：InterfaceLuid 或 InterfaceIndex。

字段按上面列出的顺序使用。因此，如果指定 了 InterfaceLuid ，则使用此成员来确定接口。如果没有为 InterfaceLuid 成员设置值， (此成员的值) 设置为零，则接下来使用 InterfaceIndex 成员来确定接口。

在输出时，将填充 Row 参数指向的MIB_IF_ROW2结构的剩余字段。

请注意， Netioapi.h 头文件会自动包含在 Iphlpapi.h 头文件中，永远不应直接使用。