GetIfEntry2 函数
GetIfEntry2 函数检索本地计算机上的指定接口的信息。
重要
对于驱动程序开发人员,建议尽可能将 GetIfEntry2Ex 与 MibIfEntryNormalWithoutStatistics 配合使用,以避免在为 NDIS OID 提供服务时出现死锁。
语法
NETIOAPI_API GetIfEntry2(
_Inout_ PMIB_IF_ROW2 Row
);
参数
-
行 [in, out]
指向成功返回的 MIB_IF_ROW2 结构的指针接收本地计算机上的接口的信息。 在输入时,驱动程序必须将 InterfaceLuid 成员或 InterfaceIndex 成员MIB_IF_ROW2结构的成员设置为接口以检索其信息。
返回值
GetIfEntry2 如果函数成功,则返回STATUS_SUCCESS。
如果函数失败,GetIfEntry2 返回以下错误代码之一:
返回代码 | 描述 |
---|---|
STATUS_INVALID_PARAMETER | 将无效参数传递给函数。 如果在 Row 参数中传递 NULL 指针,则返回此错误。 |
STATUS_NOT_FOUND | 找不到指定的接口。 如果函数找不到由 InterfaceLuid 或 InterfaceIndexRow 参数指向的 MIB_IF_ROW2 结构的成员指定的网络接口,则返回此错误。 |
其他 | 使用 FormatMessage 函数获取返回的错误的消息字符串。 |
言论
在输入时,驱动程序必须至少初始化 InterfaceLuid 或 InterfaceIndex 成员,该成员在 行 参数中传递的 MIB_IF_ROW2 结构中。 成员按前面列出的顺序使用。 因此,如果指定了 InterfaceLuid,则使用此成员来确定接口。 如果未为 InterfaceLuid 成员设置值(此成员的值设置为零),则接下来使用 InterfaceIndex 成员来确定接口。
输出时,将填充 行 参数指向的MIB_IF_ROW2结构的剩余字段。
要求
目标平台 |
通用 |
版本 |
在 Windows Vista 和更高版本的 Windows作系统中可用。 |
页眉 |
Netioapi.h (包括 Netioapi.h) |
图书馆 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |