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


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

Функция WlanGetInterfaceCapability извлекает возможности интерфейса.

Синтаксис

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

Параметры

[in] hClientHandle

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

[in] pInterfaceGuid

GUID этого интерфейса.

pReserved

Зарезервировано для последующего использования. Необходимо задать значение NULL.

[out] ppCapability

Структура WLAN_INTERFACE_CAPABILITY , содержащая сведения о возможностях указанного интерфейса.

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
hClientHandle имеет значение NULL или недопустимо, pInterfaceGuidNULL, pReserved — не NULL, ppCapabilityNULL.
ERROR_INVALID_HANDLE
Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_SUPPORTED
Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS
Различные коды ошибок.

Комментарии

Вызывающий объект отвечает за вызов функции WlanFreeMemory для освобождения памяти, выделенной для ppCapability.

Требования

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