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 将检索随 wlan_secure_permit_list 对象一起存储 (DACL ) 自由访问控制列表。 在 将 wlanFilterListType 设置为 wlan_filter_list_type_user_deny 的情况下调用时， WlanGetFilterList 将检索随 wlan_secure_deny_list 对象一起存储的 DACL。 在上述任一情况下，如果 DACL 不包含向调用线程 (的访问令牌授予WLAN_READ_ACCESS权限的 ACE) 访问控制项，则 WlanGetFilterList 将返回 ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 为 NULL 或无效， ppNetworkList 为 NULL，或 pReserved 不为 NULL。
ERROR_INVALID_HANDLE
 在句柄表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 此函数是从不受支持的平台调用的。 如果从具有 SP3 的 Windows XP 或具有 SP2 客户端的 Windows XP 无线 LAN API 调用此函数，则将返回此值。
RPC_STATUS
 各种错误代码。

注解

可以通过调用 WlanSetFilterList 来设置用户权限列表。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wlanapi.h (包括 Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

另请参阅

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList