ConvertInterfaceNameToLuidA 函数

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

注意

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

语法

NETIOAPI_API ConvertInterfaceNameToLuidA(
  _In_  const CHAR     *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

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

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

ConvertInterfaceNameToLuidA 函数与协议无关，适用于 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 头文件。

使用 ConvertInterfaceNameToLuidW 函数将 Unicode 接口名称转换为 LUID。

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