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


Функция ConvertInterfaceLuidToIndex

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

Заметка

Семейство API ConvertInterfaceXxx перечисляет идентификаторы всех интерфейсов, привязанных к TCP/IP, которые могут включать виртуальные минипорты, упрощенные фильтры, адаптеры туннеля и физические интерфейсы.

Синтаксис

NETIOAPI_API ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Параметры

  • InterfaceLuid [in]
    Указатель на объединение NET_LUID для сетевого интерфейса.

  • InterfaceIndex [out]
    Значение локального индекса для сетевого интерфейса.

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

ConvertInterfaceLuidToIndex возвращает STATUS_SUCCESS, если функция завершается успешно. Если функция завершается ошибкой, параметр InterfaceIndex имеет значение NET_IFINDEX_UNSPECIFIED, а ConvertInterfaceLuidToIndex возвращает следующий код ошибки:

Возвращаемый код Описание
STATUS_INVALID_PARAMETER

Один из параметров недопустим. ConvertInterfaceLuidToIndex возвращает эту ошибку, если InterfaceLuid или InterfaceIndexNULLили если InterfaceLuid недопустимы.

Замечания

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

Требования

Целевая платформа

универсальные

Версия

Доступно в Windows Vista и более поздних версиях операционных систем Windows.

Заголовок

Netioapi.h (include Netioapi.h)

Библиотека

Netio.lib

IRQL

PASSIVE_LEVEL

См. также

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID