convertInterfaceIndexToLuid 函数 (netioapi.h)

项目
08/25/2023

ConvertInterfaceIndexToLuid 函数将网络接口的本地索引转换为接口的本地唯一标识符 (LUID) 。

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

参数

[in] InterfaceIndex

网络接口的本地索引值。

[out] InterfaceLuid

指向此接口 NET_LUID 的指针。

返回值

成功后， ConvertInterfaceIndexToLuid 返回NO_ERROR。任何非零返回值都指示失败，InterfaceLuid 参数中返回 NULL。

错误代码	含义
ERROR_FILE_NOT_FOUND	系统找不到指定的文件。如果 InterfaceIndex 参数指定的网络接口不是本地计算机上的值，则返回此错误。
ERROR_INVALID_PARAMETER	某个参数无效。如果 InterfaceLuid 参数为 NULL 或 InterfaceIndex 参数无效，则返回此错误。

注解

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

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

要求

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