Fungsi WlanSetAutoConfigParameter (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanSetAutoConfigParameter mengatur parameter untuk layanan konfigurasi otomatis.

Sintaks

DWORD WlanSetAutoConfigParameter(
  [in] HANDLE               hClientHandle,
  [in] WLAN_AUTOCONF_OPCODE OpCode,
  [in] DWORD                dwDataSize,
  [in] const PVOID          pData,
       PVOID                pReserved
);

Parameter

[in] hClientHandle

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

[in] OpCode

Nilai WLAN_AUTOCONF_OPCODE yang menentukan parameter yang akan ditetapkan. Hanya beberapa opkode dalam operasi set dukungan enumerasi WLAN_AUTOCONF_OPCODE .

Nilai	Makna
wlan_autoconf_opcode_show_denied_networks	Ketika diatur, parameter pData akan berisi nilai BOOL yang menunjukkan apakah jaringan yang ditolak kebijakan pengguna dan grup akan disertakan dalam daftar jaringan yang tersedia.
wlan_autoconf_opcode_allow_explicit_creds	Ketika diatur, parameter pData akan berisi nilai BOOL yang menunjukkan apakah antarmuka nirkabel saat ini telah berbagi kredensial pengguna yang diizinkan.
wlan_autoconf_opcode_block_period	Ketika diatur, parameter pData akan berisi nilai DWORD untuk 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	Saat diatur, parameter pData akan berisi nilai BOOL yang menunjukkan apakah ekstensibilitas pada stasiun virtual diizinkan. Secara default, ekstensibilitas pada stasiun virtual diizinkan. Nilai untuk opcode ini dipertahankan di seluruh restart. Nilai enumerasi ini didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

[in] dwDataSize

Ukuran parameter pData , dalam byte. Parameter ini harus diatur ke sizeof(BOOL) untuk BOOL atau sizeof(DWORD) untuk DWORD, tergantung pada nilai parameter OpCode .

[in] pData

Nilai yang akan diatur untuk parameter yang ditentukan dalam parameter OpCode . Parameter pData harus menunjuk ke nilai boolean atau DWORD, tergantung pada nilai parameter OpCode . Parameter pData tidak boleh NULL.

Catatan Parameter pData dapat menunjuk ke nilai bilangan bulat saat boolean diperlukan. Jika pData menunjuk ke 0, maka nilai dikonversi ke FALSE. Jika pData menunjuk ke bilangan bulat bukan nol, maka nilai dikonversi ke TRUE.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Nilai kembali

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	Akses ditolak. Kesalahan ini dikembalikan jika pemanggil tidak memiliki izin yang memadai untuk mengatur parameter konfigurasi saat parameter OpCode wlan_autoconf_opcode_show_denied_networks atau wlan_autoconf_opcode_allow_virtual_station_extensibility. Ketika parameter OpCode diatur ke salah satu nilai ini, fungsi WlanSetAutoConfigParameter mengambil daftar kontrol akses diskresi (DACL) yang disimpan untuk objek opcode. Jika DACL tidak berisi entri kontrol akses (ACE) yang memberikan izin WLAN_WRITE_ACCESS ke token akses utas panggilan, maka WlanSetAutoConfigParameter mengembalikan ERROR_ACCESS_DENIED. Kesalahan ini juga dikembalikan jika parameter konfigurasi diatur oleh kebijakan grup pada domain. Ketika kebijakan grup diatur untuk opcode, aplikasi dicegah untuk membuat perubahan. Untuk parameter OpCode berikut dapat ditetapkan oleh kebijakan grup: wlan_autoconf_opcode_show_denied_networks, wlan_autoconf_opcode_allow_explicit_creds, dan wlan_autoconf_opcode_block_period
ERROR_INVALID_PARAMETER	Parameternya buruk. Kesalahan ini dikembalikan jika parameter hClientHandle adalah NULL, parameter pData adalah NULL, atau parameter pReserved bukan NULL. Kesalahan ini juga dikembalikan jika parameter OpCode yang ditentukan bukan salah satu nilai WLAN_AUTOCONF_OPCODE untuk parameter konfigurasi yang dapat diatur. Kesalahan ini juga dikembalikan jika parameter dwDataSize tidak diatur ke `sizeof(BOOL)`, atau dwDataSize tidak diatur ke `sizeof(BOOL)` tergantung pada nilai parameter OpCode .
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 WlanSetAutoConfigParameter mengatur parameter yang digunakan oleh Modul Konfigurasi Otomatis (ACM), komponen konfigurasi nirkabel yang didukung pada Windows Vista dan yang lebih baru.

Bergantung pada nilai parameter OpCode , data yang ditunjukkan oleh pData akan dikonversi ke nilai boolean sebelum parameter konfigurasi otomatis diatur. Jika pData menunjuk ke 0, maka parameter diatur ke FALSE; jika tidak, parameter diatur ke TRUE.

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

WlanQueryAutoConfigParameter

Bagikan melalui