Функция 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.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
Код возврата | Описание |
---|---|
|
hClientHandle имеет значение NULL или недопустимо, pInterfaceGuid — NULL, pReserved — не NULL, ppCapability — NULL. |
|
Дескриптор hClientHandle не найден в таблице дескрипторов. |
|
Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2). |
|
Различные коды ошибок. |
Комментарии
Вызывающий объект отвечает за вызов функции WlanFreeMemory для освобождения памяти, выделенной для ppCapability.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | wlanapi.h (включая Wlanapi.h) |
Библиотека | Wlanapi.lib |
DLL | Wlanapi.dll |