Fungsi WlanGetSecuritySettings (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanGetSecuritySettings mendapatkan pengaturan keamanan yang terkait dengan objek yang dapat dikonfigurasi.

Sintaks

DWORD WlanGetSecuritySettings(
  [in]            HANDLE                  hClientHandle,
  [in]            WLAN_SECURABLE_OBJECT   SecurableObject,
  [out, optional] PWLAN_OPCODE_VALUE_TYPE pValueType,
  [out]           LPWSTR                  *pstrCurrentSDDL,
  [out]           PDWORD                  pdwGrantedAccess
);

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 diterapkan.

[out, optional] pValueType

Penunjuk ke nilai WLAN_OPCODE_VALUE_TYPE yang menentukan sumber pengaturan keamanan.

Nilai	Makna
wlan_opcode_value_type_set_by_group_policy	Pengaturan keamanan ditetapkan oleh kebijakan grup.
wlan_opcode_value_type_set_by_user	Pengaturan keamanan diatur oleh pengguna. Pengguna dapat mengatur pengaturan keamanan dengan memanggil WlanSetSecuritySettings.

[out] pstrCurrentSDDL

Pada input, parameter ini harus NULL.

Pada output, parameter ini menerima penunjuk ke string deskriptor keamanan yang menentukan pengaturan keamanan untuk objek jika panggilan fungsi berhasil. Untuk informasi selengkapnya tentang string ini, lihat fungsi WlanSetSecuritySettings .

[out] pdwGrantedAccess

Masker akses objek.

Nilai	Makna
WLAN_READ_ACCESS	Pemanggil dapat melihat izin objek.
WLAN_EXECUTE_ACCESS	Penelepon dapat membaca dari dan menjalankan objek . WLAN_EXECUTE_ACCESS memiliki nilai yang sama dengan kombinasi bitwise OR WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS.
WLAN_WRITE_ACCESS	Penelepon dapat membaca dari, mengeksekusi, dan menulis ke objek. WLAN_WRITE_ACCESS memiliki nilai yang sama dengan kombinasi bitwise OR WLAN_READ_ACCESS \| WLAN_EXECUTE_ACCESS \| WLAN_WRITE_ACCESS.

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_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika salah satu kondisi berikut terjadi: hClientHandle adalah NULL. pstrCurrentSDDL adalah NULL. pdwGrantedAccess 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

Pemanggil bertanggung jawab untuk membebaskan memori yang dialokasikan untuk string deskriptor keamanan yang ditunjukkan oleh parameter pstrCurrentSDDL jika fungsi berhasil. Ketika tidak lagi diperlukan, memori untuk string deskriptor keamanan harus dibebaskan dengan memanggil fungsi WlanFreeMemory dan meneruskan parameter pstrCurrentSDDL .

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

Izin API Wifi Asli

WlanFreeMemory

WlanSetSecuritySettings

Bagikan melalui