ConvertInterfaceNameToLuidW 函数将 Unicode 网络接口名称转换为接口的本地唯一标识符（LUID）。
注意
ConvertInterfaceXxx API 系列枚举绑定到 TCP/IP 的所有接口的标识符，这些接口可能包括虚拟微型端口、轻型筛选器、隧道适配器和物理接口。
语法
NETIOAPI_API ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
参数
InterfaceName [in]
指向包含网络接口名称的以 NULL 结尾的 Unicode 字符串的指针。InterfaceLuid [out]
指向此接口的 NET_LUID 联合的指针。
返回值
如果函数成功，则 ConvertInterfaceNameToLuidW 返回STATUS_SUCCESS。 如果函数失败，ConvertInterfaceNameToLuidW 返回以下错误代码之一：
| 返回代码 | 描述 |
|---|---|
| STATUS_INVALID_NAME | 接口名称无效。 ConvertInterfaceNameToLuidW 如果 InterfaceName 参数包含无效的名称或 InterfaceName 参数的长度超过此参数允许的最大字符串长度，则返回此错误。 |
| STATUS_INVALID_PARAMETER | 其中一个参数无效。 ConvertInterfaceNameToLuidW 如果 InterfaceLuid 参数 NULL，则返回此错误。 |
言论
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 |