Share via

WlanGetFilterList (Compact 7)

  • Article

3/12/2014

This function retrieves a user permission list.

Syntax

DWORD WINAPI WlanGetFilterList(
  __in        HANDLE hClientHandle,
  __in        WLAN_FILTER_LIST_TYPE wlanFilterListType,
  __reserved  PVOID pReserved,
  __out       PDOT11_NETWORK_LIST* ppNetworkList
);

Parameters

  • hClientHandle
    The client's session handle, obtained by a previous call to the WlanOpenHandle function.
  • wlanFilterListType
    A WLAN_FILTER_LIST_TYPE value that specifies the type of filter list. All user-defined filter lists can be queried.
  • pReserved
    Reserved; set to NULL.
  • ppNetworkList
    Pointer to a DOT11_NETWORK_LIST structure that contains the list of permitted or denied networks.

Return Values

Value Description

ERROR_SUCCESS

The function succeeds.

ERROR_ACCESS_DENIED

The caller does not have sufficient permissions to retrieve the filter list.

ERROR_INVALID_PARAMETER

hClientHandle is NULL or invalid, pReserved is not NULL, or ppInterfaceList is NULL.

ERROR_INVALID_HANDLE

The handle hClientHandle was not found in the handle table.

ERROR_NOT_SUPPORTED

This function was called from an unsupported platform.

RPC_STATUS

Can be any Remote Procedure Call (RPC) error code. The RPC call may be unsuccessful due to Wlan RPC server issues, such as when the RPC server is not started. Refer to RPC for more information.

Remarks

User permission lists can be set by calling WlanSetFilterList.

See Also

Reference

Native Wi-Fi Functions
WlanOpenHandle
WLAN_FILTER_LIST_TYPE
DOT11_NETWORK_LIST
WlanSetFilterList
Native Wi-Fi Reference