Функция 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 |