Fungsi AddAuditAccessAce (securitybaseapi.h)

Artikel
03/01/2024

Fungsi AddAuditAccessAce menambahkan entri kontrol akses audit sistem (ACE) ke daftar kontrol akses sistem (ACL). Akses pengidentifikasi keamanan (SID) tertentu diaudit.

Untuk mengontrol apakah ACE baru dapat diwarisi oleh objek anak, gunakan fungsi AddAuditAccessAceEx .

Sintaks

BOOL AddAuditAccessAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceRevision,
  [in]      DWORD dwAccessMask,
  [in]      PSID  pSid,
  [in]      BOOL  bAuditSuccess,
  [in]      BOOL  bAuditFailure
);

Parameter

[in, out] pAcl

Penunjuk ke ACL. Fungsi ini menambahkan ACE audit sistem ke ACL ini. ACE dalam bentuk struktur SYSTEM_AUDIT_ACE .

[in] dwAceRevision

Menentukan tingkat revisi ACL yang sedang dimodifikasi.

Nilai ini dapat ACL_REVISION atau ACL_REVISION_DS. Gunakan ACL_REVISION_DS jika ACL berisi ACE khusus objek.

[in] dwAccessMask

Menentukan masker hak akses yang akan diaudit untuk SID yang ditentukan.

[in] pSid

Penunjuk ke SID yang mewakili proses yang aksesnya sedang diaudit.

[in] bAuditSuccess

Menentukan apakah upaya akses yang berhasil akan diaudit. Atur bendera ini ke TRUE untuk mengaktifkan audit; jika tidak, atur ke FALSE.

[in] bAuditFailure

Menentukan apakah upaya akses yang gagal akan diaudit. Atur bendera ini ke TRUE untuk mengaktifkan audit; jika tidak, atur ke FALSE.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Berikut ini adalah kemungkinan nilai kesalahan.

Menampilkan kode	Deskripsi
ERROR_ALLOTTED_SPACE_EXCEEDED	ACE baru tidak cocok dengan ACL. Buffer ACL yang lebih besar diperlukan.
ERROR_INVALID_ACL	ACL yang ditentukan tidak terbentuk dengan benar.
ERROR_INVALID_SID	SID yang ditentukan tidak valid secara struktural.
ERROR_REVISION_MISMATCH	Revisi yang ditentukan tidak diketahui atau tidak kompatibel dengan ACL.
ERROR_SUCCESS	ACE berhasil ditambahkan.

Keterangan

Struktur ACE_HEADER ditempatkan di ACE oleh fungsi AddAuditAccessAce menentukan jenis dan ukuran, tetapi tidak menyediakan bendera ACE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll