Fungsi WlanSetSecuritySettings (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanGetProfileList mengatur pengaturan keamanan untuk objek yang dapat dikonfigurasi.

Sintaks

DWORD WlanSetSecuritySettings(
  [in] HANDLE                hClientHandle,
  [in] WLAN_SECURABLE_OBJECT SecurableObject,
  [in] LPCWSTR               strModifiedSDDL
);

Parameter

[in] hClientHandle

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

[in] SecurableObject

Nilai WLAN_SECURABLE_OBJECT yang menentukan objek tempat pengaturan keamanan akan diterapkan.

[in] strModifiedSDDL

String deskriptor keamanan yang menentukan pengaturan keamanan baru untuk objek. String ini harus dihentikan NULL. Untuk informasi lebih lanjut, lihat bagian Keterangan.

Menampilkan 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_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika salah satu kondisi berikut terjadi: hClientHandle adalah NULL. strModifiedSDDL adalah NULL. SecurableObject diatur ke nilai yang lebih besar dari atau sama dengan WLAN_SECURABLE_OBJECT_COUNT (12).
ERROR_INVALID_HANDLE	Handel tidak valid. Kesalahan ini dikembalikan jika handel yang ditentukan dalam parameter hClientHandle tidak ditemukan dalam tabel handel.
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai.
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.

Keterangan

Panggilan yang berhasil ke fungsi WlanSetSecuritySettings mengambil alih izin default yang terkait dengan objek. Untuk informasi selengkapnya tentang izin default, lihat Izin API Wifi Asli.

Berikut ini menjelaskan prosedur untuk membuat objek deskriptor keamanan dan mengurainya sebagai string.

Panggil InitializeSecurityDescriptor untuk membuat deskriptor keamanan dalam memori.
Panggil SetSecurityDescriptorOwner untuk mengatur informasi pemilik untuk deskriptor keamanan.
Panggil InitializeAcl untuk membuat daftar kontrol akses diskresi (DACL) dalam memori.
Panggil AddAccessAllowedAce atau AddAccessDeniedAce untuk menambahkan entri kontrol akses (ACE) ke DACL. Atur parameter AccessMask ke salah satu kombinasi bitwise OR berikut ini sebagaimana merujuk:
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
Panggil SetSecurityDescriptorDacl untuk menambahkan DACL ke deskriptor keamanan.
Panggil ConvertSecurityDescriptorToStringSecurityDescriptor untuk mengonversi deskriptor menjadi string.

String yang dikembalikan oleh ConvertSecurityDescriptorToStringSecurityDescriptor kemudian dapat digunakan sebagai nilai parameter strModifiedSDDL saat memanggil WlanSetSecuritySettings.

Persyaratan


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

Izin API Wifi Asli

WlanGetSecuritySettings

Bagikan melalui