WlanGetFilterList function (wlanapi.h)
The WlanGetFilterList function retrieves a group policy or user permission list.
Syntax
DWORD WlanGetFilterList(
[in] HANDLE hClientHandle,
[in] WLAN_FILTER_LIST_TYPE wlanFilterListType,
PVOID pReserved,
[out] PDOT11_NETWORK_LIST *ppNetworkList
);
Parameters
[in] hClientHandle
The client's session handle, obtained by a previous call to the WlanOpenHandle function.
[in] wlanFilterListType
A WLAN_FILTER_LIST_TYPE value that specifies the type of filter list. All user defined and group policy filter lists can be queried.
pReserved
Reserved for future use. Must be set to NULL.
[out] ppNetworkList
Pointer to a DOT11_NETWORK_LIST structure that contains the list of permitted or denied networks.
Return value
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value may be one of the following return codes.
| Return code | Description |
|---|---|
|
The caller does not have sufficient permissions to get the filter list.
When called with wlanFilterListType set to wlan_filter_list_type_user_permit, WlanGetFilterList retrieves the discretionary access control list (DACL) stored with the wlan_secure_permit_list object. When called with wlanFilterListType set to wlan_filter_list_type_user_deny, WlanGetFilterList retrieves the DACL stored with the wlan_secure_deny_list object. In either of these cases, if the DACL does not contain an access control entry (ACE) that grants WLAN_READ_ACCESS permission to the access token of the calling thread, then WlanGetFilterList returns ERROR_ACCESS_DENIED. |
|
hClientHandle is NULL or invalid, ppNetworkList is NULL, or pReserved is not NULL. |
|
The handle hClientHandle was not found in the handle table. |
|
This function was called from an unsupported platform. This value will be returned if this function was called from a Windows XP with SP3 or Wireless LAN API for Windows XP with SP2 client. |
|
Various error codes. |
Remarks
User permission lists can be set by calling WlanSetFilterList.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | wlanapi.h (include Wlanapi.h) |
| Library | Wlanapi.lib |
| DLL | Wlanapi.dll |