ConvertInterfaceIndexToLuid 函数

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

注意

ConvertInterfaceXxx API 系列枚举绑定到 TCP/IP 的所有接口上的标识符,其中可能包括虚拟微型端口、轻型筛选器、隧道适配器和物理接口。

语法

NETIOAPI_API ConvertInterfaceIndexToLuid(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PNET_LUID   InterfaceLuid
);

参数

  • InterfaceIndex [in]
    网络接口的本地索引值。

  • InterfaceLuid [out]
    指向网络接口 的NET_LUID 联合的指针。

返回值

如果函数成功,ConvertInterfaceIndexToLuid 将返回STATUS_SUCCESS。 如果函数失败, InterfaceLuid 参数设置为 NULLConvertInterfaceIndexToLuid 将返回以下错误代码:

返回代码 说明
STATUS_INVALID_PARAMETER

某个参数无效。 如果 InterfaceLuid 参数为 NULL 或 InterfaceIndex 参数无效,ConvertInterfaceIndexToLuid 将返回此错误。

注解

ConvertInterfaceIndexToLuid 函数与协议无关,适用于 IPv6 和 IPv4 协议的网络接口。

要求

目标平台

通用

版本

在 Windows Vista 和更高版本的 Windows 操作系统中可用。

标头

Netioapi.h (包括 Netioapi.h)

Netio.lib

IRQL

PASSIVE_LEVEL

另请参阅

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID