Fungsi WlanGetFilterList (wlanapi.h)

Fungsi WlanGetFilterList mengambil kebijakan grup atau daftar izin pengguna.

Sintaks

DWORD WlanGetFilterList(
  [in]  HANDLE                hClientHandle,
  [in]  WLAN_FILTER_LIST_TYPE wlanFilterListType,
        PVOID                 pReserved,
  [out] PDOT11_NETWORK_LIST   *ppNetworkList
);

Parameter

[in] hClientHandle

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

[in] wlanFilterListType

Nilai WLAN_FILTER_LIST_TYPE yang menentukan jenis daftar filter. Semua daftar filter kebijakan yang ditentukan pengguna dan grup dapat dikueri.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

[out] ppNetworkList

Penunjuk ke struktur DOT11_NETWORK_LIST yang berisi daftar jaringan yang diizinkan atau ditolak.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai untuk mendapatkan daftar filter. Ketika dipanggil dengan wlanFilterListType diatur ke wlan_filter_list_type_user_permit, WlanGetFilterList 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, WlanGetFilterList 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_READ_ACCESS ke token akses utas panggilan, maka WlanGetFilterList mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle adalah NULL atau tidak valid, ppNetworkList adalah NULL, 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 pengguna dapat diatur dengan memanggil WlanSetFilterList.

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

DOT11_NETWORK_LIST

WLAN_FILTER_LIST_TYPE

WlanSetFilterList