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

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

  • Статья

Функция WlanGetFilterList извлекает групповую политику или список разрешений пользователей.

Синтаксис

DWORD WlanGetFilterList(
  [in]  HANDLE                hClientHandle,
  [in]  WLAN_FILTER_LIST_TYPE wlanFilterListType,
        PVOID                 pReserved,
  [out] PDOT11_NETWORK_LIST   *ppNetworkList
);

Параметры

[in] hClientHandle

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

[in] wlanFilterListType

Значение WLAN_FILTER_LIST_TYPE , указывающее тип списка фильтров. Можно запрашивать все определяемые пользователем списки и списки фильтров групповой политики.

pReserved

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

[out] ppNetworkList

Указатель на структуру DOT11_NETWORK_LIST , содержащую список разрешенных или запрещенных сетей.

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
 Вызывающий объект не имеет достаточных разрешений для получения списка фильтров.

При вызове с параметром wlanFilterListType , для которого задано значение wlan_filter_list_type_user_permit, WlanGetFilterList извлекает список управления доступом на уровне пользователей (DACL), хранящийся в объекте wlan_secure_permit_list . При вызове с параметром wlanFilterListType , для которого задано значение wlan_filter_list_type_user_deny, WlanGetFilterList извлекает список DACL, хранящийся в объекте wlan_secure_deny_list . В любом из этих случаев, если DACL не содержит запись управления доступом (ACE), которая предоставляет WLAN_READ_ACCESS разрешение маркеру доступа вызывающего потока, WlanGetFilterList возвращает ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER
 hClientHandle имеет значение NULL или недопустимо, ppNetworkList имеет значение NULL или pReserved не равно NULL.
ERROR_INVALID_HANDLE
 Дескриптор hClientHandle не найден в таблице дескрипторов.
ERROR_NOT_SUPPORTED
 Эта функция была вызвана из неподдерживаемой платформы. Это значение будет возвращено, если эта функция была вызвана из клиента Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2).
RPC_STATUS
 Различные коды ошибок.

Комментарии

Списки разрешений пользователей можно задать, вызвав WlanSetFilterList.

Требования

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

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

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList