ConvertInterfaceLuidToAlias 函数 (netioapi.h)

项目
02/29/2024

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

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToAlias(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PWSTR          InterfaceAlias,
  [in]  SIZE_T         Length
);

参数

[in] InterfaceLuid

指向网络接口 NET_LUID 的指针。

[out] InterfaceAlias

指向缓冲区的指针，用于保存函数成功返回时包含网络接口别名的 以 NULL 结尾的 Unicode 字符串。

[in] Length

InterfaceAlias 参数指向的缓冲区的长度（以字符为单位）。此值必须足够大，以容纳网络接口的别名和终止 NULL 字符。所需最大长度为 NDIS_IF_MAX_STRING_SIZE + 1。

返回值

成功后， ConvertInterfaceLuidToAlias 返回NO_ERROR。任何非零返回值都表示失败。

错误代码	含义
ERROR_INVALID_PARAMETER	某个参数无效。如果 InterfaceLuid 或 InterfaceAlias 参数为 NULL ，或者 InterfaceLuid 参数无效，则返回此错误。
ERROR_NOT_ENOUGH_MEMORY	没有足够的存储空间可用于处理此命令。如果 InterfaceAlias 参数指向的缓冲区大小不够大，无法按 Length 参数中指定的大小来保存别名，则返回此错误。

注解

ConvertInterfaceLuidToAlias 函数在 Windows Vista 及更高版本上可用。

ConvertInterfaceLuidToAlias 函数独立于协议，适用于 IPv6 和 IPv4 协议的网络接口。

在 Ntddndis.h 头文件中声明没有终止 NULL 的网络接口别名的最大长度NDIS_IF_MAX_STRING_SIZE。 NDIS_IF_MAX_STRING_SIZE定义为 Ifdef.h 头文件中定义的IF_MAX_STRING_SIZE常量。 Ntddndis.h 和 Ifdef.h 头文件自动包含在 Iphlpapi.h 头文件自动包含的 Netioapi.h 头文件中。永远不应直接使用 Ntddndis.h、 Ifdef.h 和 Netioapi.h 头文件。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	netioapi.h (包括 Iphlpapi.h)
Library	Iphlpapi.lib
DLL	Iphlpapi.dll