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


Функция ConvertInterfaceLuidToGuid

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

Примечание

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

Синтаксис

NETIOAPI_API ConvertInterfaceLuidToGuid(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       GUID     *InterfaceGuid
);

Параметры

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

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

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

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

Код возврата Описание
STATUS_INVALID_PARAMETER

Один из параметров недопустим. ConvertInterfaceLuidToGuid возвращает эту ошибку, если InterfaceLuid или InterfaceGuid имеет значение NULL или если InterfaceLuid недопустим.

Комментарии

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

Требования

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

Универсальное

Версия

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

Заголовок

Netioapi.h (включая Netioapi.h)

Библиотека

Netio.lib

IRQL

PASSIVE_LEVEL

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

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID