共用方式為

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。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權可取得篩選清單。

使用 wlanFilterListType 設定為 wlan_filter_list_type_user_permit呼叫時， WlanGetFilterList 會擷取 (DACL) 與 wlan_secure_permit_list 物件一起儲存的任意訪問控制清單。 使用 wlanFilterListType 設定為 wlan_filter_list_type_user_deny 呼叫時， WlanGetFilterList 會擷取以 wlan_secure_deny_list 物件儲存的 DACL。 在這其中一種情況下，如果 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
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

您可以呼叫 WlanSetFilterList 來設定使用者許可權清單。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll

另請參閱

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList