Поделиться через


Функция ConvertInterfaceLuidToIndex (netioapi.h)

Функция ConvertInterfaceLuidToIndex преобразует локальный уникальный идентификатор (LUID) сетевого интерфейса в локальный индекс интерфейса.

Синтаксис

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToIndex(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PNET_IFINDEX   InterfaceIndex
);

Параметры

[in] InterfaceLuid

Указатель на NET_LUID для сетевого интерфейса.

[out] InterfaceIndex

Значение локального индекса для интерфейса.

Возвращаемое значение

При успешном выполнении функция ConvertInterfaceLuidToIndex возвращает NO_ERROR. Любое ненулевое возвращаемое значение указывает на сбой, а в параметре InterfaceIndex возвращается NET_IFINDEX_UNSPECIFIED.

Код ошибки Значение
ERROR_INVALID_PARAMETER
Один из параметров был недопустимым. Эта ошибка возвращается, если параметр InterfaceLuid или InterfaceIndex имеет значение NULL или если параметр InterfaceLuid был недопустимым.

Комментарии

Функция ConvertInterfaceLuidToIndex доступна в Windows Vista и более поздних версиях.

Функция ConvertInterfaceLuidToIndex не зависит от протокола и работает с сетевыми интерфейсами для протоколов IPv6 и IPv4.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

См. также раздел

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex