ConvertInterfaceAliasToLuid 函数 (netioapi.h)

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

语法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

参数

[in] InterfaceAlias

指向以 NULL 结尾的 Unicode 字符串的指针,其中包含网络接口的别名。

[out] InterfaceLuid

指向此接口 NET_LUID 的指针。

返回值

成功后, ConvertInterfaceAliasToLuid 返回NO_ERROR。 任何非零返回值都表示失败,InterfaceLuid 参数中返回 NULL

错误代码 含义
ERROR_INVALID_PARAMETER
某个参数无效。 如果 InterfaceAliasInterfaceLuid 参数为 NULL ,或者 InterfaceAlias 参数无效,则返回此错误。

注解

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

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

要求

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

另请参阅

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex