Fungsi WlanQueryAutoConfigParameter (wlanapi.h)

Artikel
03/04/2024

Kueri fungsi WlanQueryAutoConfigParameter untuk parameter layanan konfigurasi otomatis.

Sintaks

DWORD WlanQueryAutoConfigParameter(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_AUTOCONF_OPCODE    OpCode,
                  PVOID                   pReserved,
  [out]           PDWORD                  pdwDataSize,
  [out]           PVOID                   *ppData,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType
);

Parameter

[in] hClientHandle

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

[in] OpCode

Nilai yang menentukan parameter konfigurasi yang akan dikueri.

Nilai	Makna
wlan_autoconf_opcode_show_denied_networks	Ketika diatur, parameter ppData akan berisi nilai BOOL yang menunjukkan apakah jaringan yang ditolak kebijakan pengguna dan grup akan disertakan dalam daftar jaringan yang tersedia. Jika fungsi mengembalikan ERROR_SUCCESS dan ppData menunjuk ke TRUE, maka jaringan yang ditolak kebijakan pengguna dan grup akan disertakan dalam daftar jaringan yang tersedia; jika FALSE, jaringan yang ditolak kebijakan pengguna dan grup tidak akan disertakan dalam daftar jaringan yang tersedia.
wlan_autoconf_opcode_power_setting	Saat diatur, parameter ppData akan berisi nilai WLAN_POWER_SETTING yang menentukan pengaturan daya.
wlan_autoconf_opcode_only_use_gp_profiles_for_allowed_networks	Saat diatur, parameter ppData akan berisi nilai BOOL yang menunjukkan apakah profil yang tidak dibuat oleh kebijakan grup dapat digunakan untuk menyambungkan ke jaringan yang diizinkan dengan profil kebijakan grup yang cocok. Jika fungsi mengembalikan ERROR_SUCCESS dan ppData menunjuk ke TRUE, maka hanya profil yang dibuat oleh kebijakan grup yang dapat digunakan; jika FALSE, profil apa pun dapat digunakan.
wlan_autoconf_opcode_allow_explicit_creds	Ketika diatur, parameter ppData akan berisi nilai BOOL yang menunjukkan apakah antarmuka nirkabel saat ini memiliki kredensial pengguna bersama yang diizinkan. Jika fungsi mengembalikan ERROR_SUCCESS dan ppData menunjuk ke TRUE, maka antarmuka nirkabel saat ini memiliki kredensial pengguna bersama yang diizinkan; jika FALSE, antarmuka nirkabel saat ini tidak memperbolehkan kredensial pengguna bersama.
wlan_autoconf_opcode_block_period	Ketika diatur, parameter ppData akan berisi nilai DWORD yang menunjukkan pengaturan periode yang diblokir untuk antarmuka nirkabel saat ini. Periode yang diblokir adalah jumlah waktu, dalam detik, yang koneksi otomatisnya ke jaringan nirkabel tidak akan dicoba setelah kegagalan sebelumnya.
wlan_autoconf_opcode_allow_virtual_station_extensibility	Ketika diatur, parameter ppData akan berisi nilai BOOL yang menunjukkan apakah ekstensibilitas pada stasiun virtual diizinkan. Secara default, ekstensibilitas pada stasiun virtual diizinkan. Nilai untuk opcode ini bertahan di seluruh restart. Jika fungsi mengembalikan ERROR_SUCCESS dan ppData menunjuk ke TRUE, ekstensibilitas pada stasiun virtual diizinkan; jika FALSE, ekstensibilitas pada stasiun virtual tidak diizinkan.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

[out] pdwDataSize

Menentukan ukuran parameter ppData , dalam byte.

[out] ppData

Arahkan ke memori yang berisi nilai yang dikueri untuk parameter yang ditentukan dalam OpCode.

Catatan Jika OpCode diatur ke wlan_autoconf_opcode_show_denied_networks, maka pointer yang direferensikan oleh ppData dapat menunjuk ke nilai bilangan bulat. Jika pointer yang direferensikan oleh ppData menunjuk ke 0, maka nilai bilangan bulat harus dikonversi ke nilai boolean FALSE. Jika pointer yang direferensikan oleh ppData menunjuk ke bilangan bulat bukan nol, maka nilai bilangan bulat harus dikonversi ke nilai boolean TRUE.

[out, optional] pWlanOpcodeValueType

Nilai WLAN_OPCODE_VALUE_TYPE .

Nilai kembali

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 parameter konfigurasi. Ketika dipanggil dengan OpCode diatur ke wlan_autoconf_opcode_show_denied_networks, WlanQueryAutoConfigParameter mengambil daftar kontrol akses diskresi (DACL) yang disimpan dengan objek wlan_secure_show_denied . Jika DACL tidak berisi entri kontrol akses (ACE) yang memberikan izin WLAN_READ_ACCESS ke token akses utas panggilan, maka WlanQueryAutoConfigParameter mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle adalah NULL atau tidak valid, pReserved bukan NULL, ppData adalah NULL, atau pdwDataSize adalah 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

Fungsi WlanQueryAutoConfigParameter meminta parameter yang digunakan oleh Modul Konfigurasi Otomatis (ACM), komponen konfigurasi nirkabel yang didukung pada Windows Vista dan yang lebih baru.

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

WLAN_AUTOCONF_OPCODE

WlanSetAutoConfigParameter

Bagikan melalui