Fungsi AuditQuerySecurity (ntsecapi.h)

Artikel
03/05/2024

Fungsi AuditQuerySecurity mengambil deskriptor keamanan yang mendelegasikan akses ke kebijakan audit.

Sintaks

BOOLEAN AuditQuerySecurity(
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor
);

Parameter

[in] SecurityInformation

Nilai SECURITY_INFORMATION yang menentukan bagian mana dari deskriptor keamanan yang ditetapkan fungsi ini. Hanya SACL_SECURITY_INFORMATION dan DACL_SECURITY_INFORMATION yang didukung. Nilai lain diabaikan. Jika tidak ada SACL_SECURITY_INFORMATION atau DACL_SECURITY_INFORMATION yang ditentukan, fungsi ini gagal dan mengembalikan ERROR_INVALID_PARAMETER.

[out] ppSecurityDescriptor

Alamat pointer ke struktur SECURITY_DESCRIPTOR yang terbentuk dengan baik yang mengontrol akses ke objek keamanan Audit.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. GetLastError dapat mengembalikan salah satu kode kesalahan berikut yang ditentukan dalam WinError.h.

Mengembalikan kode/nilai	Deskripsi
ERROR_ACCESS_DENIED 5	Pemanggil tidak memiliki hak istimewa atau hak akses yang diperlukan untuk memanggil fungsi ini.
ERROR_INVALID_PARAMETER 87	Satu atau beberapa parameter tidak valid.

Keterangan

Agar berhasil memanggil fungsi ini, pemanggil harus memiliki SeSecurityPrivilege.

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	ntsecapi.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

AuditSetSecurity

Bagikan melalui