共用方式為

WlanSetFilterList 函式 (wlanapi.h)

  • 發行項

WlanSetFilterList 函式會設定允許/拒絕清單。

語法

DWORD WlanSetFilterList(
  [in]           HANDLE                    hClientHandle,
  [in]           WLAN_FILTER_LIST_TYPE     wlanFilterListType,
  [in, optional] const PDOT11_NETWORK_LIST pNetworkList,
                 PVOID                     pReserved
);

參數

[in] hClientHandle

用戶端的會話句柄，由先前呼叫 WlanOpenHandle 函式取得。

[in] wlanFilterListType

指定篩選清單類型的 WLAN_FILTER_LIST_TYPE 值。 此值必須是 wlan_filter_list_type_user_permit 或 wlan_filter_list_type_user_deny。 無法使用此函式來設定組策略定義的清單。

[in, optional] pNetworkList

包含允許或拒絕之網路清單之 DOT11_NETWORK_LIST 結構的指標。 結構的 dwIndex 成員必須小於結構 dwNumberOfItems 成員的值;否則，可能會發生存取違規。

pReserved

保留供未來使用。 必須設定為 NULL。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

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

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

使用 wlanFilterListType 設定為 wlan_filter_list_type_user_permit呼叫時， WlanSetFilterList 會擷取 (DACL) 與 wlan_secure_permit_list 物件一起儲存的任意訪問控制清單。 使用 wlanFilterListType 設定為 wlan_filter_list_type_user_deny 呼叫時， WlanSetFilterList 會擷取以 wlan_secure_deny_list 物件儲存的 DACL。 在這兩種情況下，如果 DACL 不包含存取控制專案 (ACE) ，該專案會授與呼叫線程存取令牌的WLAN_WRITE_ACCESS許可權， 則 WlanSetFilterList 會傳回 ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 為 NULL 或無效或 pReserved 不是 NULL。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

備註

組策略允許和拒絕清單的優先順序高於使用者的允許和拒絕清單。 這表示如果網路出現在組策略拒絕清單中，使用者允許清單上的網路存取將會遭到拒絕。 同樣地，如果網路出現在組策略允許清單上，則允許存取使用者的拒絕清單上的網路。 不允許不在使用者清單或組策略清單上的網路。

拒絕的網路無法透過自動設定連線，且不會包含在可見的網路清單中。 新的使用者允許和拒絕清單會覆寫舊版的用戶清單。

若要清除篩選清單，請將 pNetworkList 參數設定為 NULL，或將指標傳遞至已將 dwNumberOfItems 成員設為 0 的DOT11_NETWORK_LIST結構。

若要將所有 SSID 新增至篩選清單，請將指標傳遞至具有其DOT11_SSID結構之 DOT11_SSID 結構之 uSSIDLength 成員的相關聯 DOT11_NETWORK DOT11_NETWORK_LIST結構指標。

若要將所有 BSS 類型新增至篩選清單，請將指標傳遞至具有其 dot11BssType 成員設定為 dot11_BSS_type_any 相關聯DOT11_NETWORK結構的DOT11_NETWORK_LIST。

netsh wlan 新增篩選和 netsh wlan 刪除篩選命令會在命令行提供類似的功能。 如需詳細資訊，請參閱 無線區域網路的 Netsh 命令 (wlan) 。

規格需求

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

另請參閱

WlanGetFilterList