Bagikan melalui

Fungsi AuditQuerySecurity (ntsecapi.h)

  • Artikel

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