convertInterfaceLuidToNameA 函数 (netioapi.h)
ConvertInterfaceLuidToNameA 函数将网络接口的本地唯一标识符 (LUID) 转换为 ANSI 接口名称。
语法
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToNameA(
[in] const NET_LUID *InterfaceLuid,
[out] PSTR InterfaceName,
[in] SIZE_T Length
);
参数
[in] InterfaceLuid
指向网络接口 NET_LUID 的指针。
[out] InterfaceName
指向缓冲区的指针,用于保存函数成功返回时包含接口名称的 以 NULL 结尾的 ANSI 字符串。
[in] Length
InterfaceName 参数指向的缓冲区的长度(以字节为单位)。 此值必须足够大,以便容纳接口名称和终止 null 字符。 所需最大长度为 NDIS_IF_MAX_STRING_SIZE + 1。
返回值
成功后, ConvertInterfaceLuidToNameA 返回 NETIO_ERROR_SUCCESS。 任何非零返回值都表示失败。
错误代码 | 含义 |
---|---|
|
某个参数无效。 如果 InterfaceLuid 或 InterfaceName 参数为 NULL ,或者 InterfaceLuid 参数无效,则返回此错误。 |
|
没有足够的存储空间可用于处理此命令。 如果 InterfaceName 参数指向的缓冲区大小不够大,不能按 Length 参数中指定的大小来保存接口名称,则返回此错误。 |
注解
ConvertInterfaceLuidToNameA 函数在 Windows Vista 及更高版本上可用。
ConvertInterfaceLuidToNameA 函数独立于协议,适用于 IPv6 和 IPv4 协议的网络接口。 ConvertInterfaceLuidToNameA 将网络接口 LUID 转换为 ANSI 接口名称。
ConvertInterfaceLuidToNameW 将网络接口 LUID 转换为 Unicode 接口名称。
在 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 |