Fungsi WlanSetFilterList (wlanapi.h)

Artikel
03/09/2024

Fungsi WlanSetFilterList menetapkan daftar izin/tolak.

Sintaks

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

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] wlanFilterListType

Nilai WLAN_FILTER_LIST_TYPE yang menentukan jenis daftar filter. Nilai harus wlan_filter_list_type_user_permit atau wlan_filter_list_type_user_deny. Daftar yang ditentukan kebijakan grup tidak dapat diatur menggunakan fungsi ini.

[in, optional] pNetworkList

Arahkan ke struktur DOT11_NETWORK_LIST yang berisi daftar jaringan yang akan diizinkan atau ditolak. Anggota dwIndex dari struktur harus memiliki nilai yang kurang dari nilai anggota dwNumberOfItems dari struktur; jika tidak, pelanggaran akses dapat terjadi.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin salah satu kode pengembalian berikut.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai untuk mengatur daftar filter. Ketika dipanggil dengan wlanFilterListType diatur ke wlan_filter_list_type_user_permit, WlanSetFilterList mengambil daftar kontrol akses diskresi (DACL) yang disimpan dengan objek wlan_secure_permit_list . Ketika dipanggil dengan wlanFilterListType diatur ke wlan_filter_list_type_user_deny, WlanSetFilterList mengambil DACL yang disimpan dengan objek wlan_secure_deny_list . Dalam salah satu kasus ini, jika DACL tidak berisi entri kontrol akses (ACE) yang memberikan izin WLAN_WRITE_ACCESS ke token akses utas panggilan, maka WlanSetFilterList mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle adalah NULL atau tidak valid atau pReserved bukan NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
ERROR_NOT_SUPPORTED	Fungsi ini dipanggil dari platform yang tidak didukung. Nilai ini akan dikembalikan jika fungsi ini dipanggil dari Windows XP dengan SP3 atau WIRELESS LAN API untuk Windows XP dengan klien SP2.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Daftar izin dan tolak kebijakan grup lebih diutamakan daripada daftar izin dan tolak pengguna. Itu berarti akses ke jaringan pada daftar izin pengguna akan ditolak jika jaringan muncul di daftar penolakan kebijakan grup. Demikian pula, akses ke jaringan pada daftar tolak pengguna akan diizinkan jika jaringan muncul di daftar izin kebijakan grup. Jaringan yang tidak ada dalam daftar pengguna atau daftar kebijakan grup akan diizinkan.

Jaringan yang ditolak tidak dapat dihubungkan dengan cara konfigurasi otomatis dan tidak akan disertakan dalam daftar jaringan yang terlihat. Daftar izin dan tolak pengguna baru menimpa versi daftar pengguna sebelumnya.

Untuk menghapus daftar filter, atur parameter pNetworkList ke NULL, atau teruskan penunjuk ke struktur DOT11_NETWORK_LIST yang memiliki anggota dwNumberOfItems yang diatur ke 0.

Untuk menambahkan semua SSID ke daftar filter, teruskan penunjuk ke struktur DOT11_NETWORK_LIST dengan struktur DOT11_NETWORK terkait yang memiliki anggota uSSIDLength dari struktur DOT11_SSID diatur ke 0.

Untuk menambahkan semua jenis BSS ke daftar filter, teruskan penunjuk ke DOT11_NETWORK_LIST dengan struktur DOT11_NETWORK terkait yang memiliki anggota dot11BssType yang diatur ke dot11_BSS_type_any.

Perintah filter netsh wlan add filter dan netsh wlan delete menyediakan fungsionalitas serupa di baris perintah. Untuk informasi selengkapnya, lihat Perintah Netsh untuk Jaringan Area Lokal Nirkabel (wlan).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanapi.lib
DLL	Wlanapi.dll

Lihat juga

WlanGetFilterList

Bagikan melalui