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


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

Функция 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
Header netioapi.h (включая Iphlpapi.h)
Библиотека Iphlpapi.lib
DLL Iphlpapi.dll

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

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex