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


Функция ConvertInterfaceAliasToLuid

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

Заметка

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

Синтаксис

NETIOAPI_API ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Параметры

  • InterfaceAlias [in]
    Указатель на строку Юникода, завершающую значение NULL, которая содержит псевдоним сетевого интерфейса.

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

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

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

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

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

Замечания

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

Требования

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

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

Версия

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

Заголовок

Netioapi.h (include Netioapi.h)

Библиотека

Netio.lib

IRQL

PASSIVE_LEVEL

См. также

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID