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


Функция ConvertInterfaceGuidToLuid

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

Заметка

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

Синтаксис

NETIOAPI_API ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Параметры

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

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

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

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

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

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

Замечания

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

Требования

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

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

Версия

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

Заголовок

Netioapi.h (include Netioapi.h)

Библиотека

Netio.lib

IRQL

PASSIVE_LEVEL

См. также

ConvertInterfaceAliasToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID