Fungsi AuditSetPerUserPolicy (ntsecapi.h)

Artikel
02/29/2024

Fungsi AuditSetPerUserPolicy menetapkan kebijakan audit per pengguna dalam satu atau beberapa subkategori audit untuk prinsipal yang ditentukan.

Sintaks

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

Parameter

[in] pSid

Penunjuk ke struktur SID yang terkait dengan prinsipal untuk menetapkan kebijakan audit. Kebijakan per pengguna untuk SID grup saat ini tidak didukung.

[in] pAuditPolicy

Penunjuk ke array struktur AUDIT_POLICY_INFORMATION . Setiap struktur menentukan kebijakan audit per pengguna untuk satu subkataan audit.

Anggota AuditCategoryGuid dari struktur ini diabaikan.

[in] dwPolicyCount

Jumlah elemen dalam array pAuditPolicy .

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.
ERROR_NO_SUCH_USER 1317	Struktur SID yang ditentukan oleh parameter pSID tidak terkait dengan pengguna yang ada.

Keterangan

Agar berhasil memanggil fungsi ini, pemanggil harus memiliki SeSecurityPrivilege atau memiliki akses AUDIT_SET_USER_POLICY pada objek keamanan Audit.

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

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy

Bagikan melalui