Функция WlanIhvControl (wlanapi.h)

Статья
08/28/2023

Функция WlanIhvControl предоставляет механизм для независимого поставщика оборудования (IHV) управления драйверами или службами WLAN.

Синтаксис

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, полученный при предыдущем вызове функции WlanOpenHandle .

[in] pInterfaceGuid

GUID интерфейса.

[in] Type

Структура WLAN_IHV_CONTROL_TYPE , указывающая тип программного обеспечения, которое обходят функцией управления IHV.

[in] dwInBufferSize

Размер входного буфера (в байтах).

[in] pInBuffer

Универсальный буфер для входных данных драйвера или интерфейса службы.

[in] dwOutBufferSize

Размер выходного буфера (в байтах).

[in, out, optional] pOutBuffer

Универсальный буфер для выходных данных интерфейса драйвера или службы.

[out] pdwBytesReturned

Число возвращаемых байтов.

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

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных разрешений для выполнения этой операции. При вызове WlanIhvControl извлекает список управления доступом на уровне пользователей (DACL), хранящийся вместе с объектом wlan_secure_ihv_control . Если DACL не содержит запись управления доступом (ACE), которая предоставляет WLAN_WRITE_ACCESS разрешение маркеру доступа вызывающего потока, то WlanIhvControl возвращает ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle имеет значение NULL или недопустимо, pInterfaceGuid имеет значение NULL, или pdwBytesReturned имеет значение NULL.
ERROR_INVALID_HANDLE	Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_SUPPORTED	Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS	Различные коды ошибок.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h (включая Wlanapi.h)
Библиотека	Wlanapi.lib
DLL	Wlanapi.dll

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

WLAN_IHV_CONTROL_TYPE

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