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