ConvertInterfaceNameToLuidW 函数

ConvertInterfaceNameToLuidW 函数将 Unicode 网络接口名称转换为接口的 LUID) (本地唯一标识符。

注意

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

语法

NETIOAPI_API ConvertInterfaceNameToLuidW(
  _In_  const WCHAR    *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

如果函数成功，ConvertInterfaceNameToLuidW 将返回STATUS_SUCCESS。如果函数失败， ConvertInterfaceNameToLuidW 将返回以下错误代码之一：

返回代码	说明
STATUS_INVALID_NAME	接口名称无效。如果 InterfaceName 参数包含无效名称或 InterfaceName 参数的长度超过此参数允许的最大字符串长度，ConvertInterfaceNameToLuidW 将返回此错误。
STATUS_INVALID_PARAMETER	其中一个参数无效。如果 InterfaceLuid 参数为 NULL，ConvertInterfaceNameToLuidW 将返回此错误。

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

在 Ntddndis.h 头文件中定义网络接口名称的最大长度NDIS_IF_MAX_STRING_SIZE（不含终止 NULL 字符）。 NDIS_IF_MAX_STRING_SIZE定义为在 Ifdef.h 头文件中定义的IF_MAX_STRING_SIZE常量。

注意

Ntddndis.h 和 Ifdef.h 头文件将自动包含在 Netioapi.h 头文件中。切勿直接使用 Ntddndis.h 和 Ifdef.h 头文件。

使用 ConvertInterfaceNameToLuidA 函数将 ANSI 接口名称转换为 LUID。

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