ConvertInterfaceLuidToIndex 函数

项目
06/15/2023

ConvertInterfaceLuidToIndex 函数将网络接口的本地唯一标识符 (LUID) 转换为接口的本地索引。

注意

ConvertInterfaceXxx API 系列枚举绑定到 TCP/IP 的所有接口上的标识符，这些接口可能包括虚拟微型端口、轻型筛选器、隧道适配器和物理接口。

语法

NETIOAPI_API ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

参数

InterfaceLuid [in]
指向网络接口 NET_LUID 联合的指针。
InterfaceIndex [out]
网络接口的本地索引值。

返回值

如果函数成功，ConvertInterfaceLuidToIndex 将返回STATUS_SUCCESS。如果函数失败， InterfaceIndex 参数将设置为 NET_IFINDEX_UNSPECIFIED，并且 ConvertInterfaceLuidToIndex 将返回以下错误代码：

返回代码	说明
STATUS_INVALID_PARAMETER	其中一个参数无效。如果 InterfaceLuid 或 InterfaceIndex 为 NULL，或者 InterfaceLuid 无效，ConvertInterfaceLuidToIndex 将返回此错误。

注解

ConvertInterfaceLuidToIndex 函数与协议无关，适用于 IPv6 和 IPv4 协议的网络接口。

要求

目标平台	通用
版本	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头	Netioapi.h (包括 Netioapi.h)
库	Netio.lib
IRQL	PASSIVE_LEVEL