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


Функция ConvertInterfaceIndexToLuid

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

Заметка

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

Синтаксис

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

Параметры

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

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

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

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

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

Один из параметров недопустим. ConvertInterfaceIndexToLuid возвращает эту ошибку, если параметр InterfaceLuidNULLили недопустимый параметр InterfaceIndex.

Замечания

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

Требования

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

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

Версия

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

Заголовок

Netioapi.h (include Netioapi.h)

Библиотека

Netio.lib

IRQL

PASSIVE_LEVEL

См. также

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID