Fungsi AuditQueryPerUserPolicy (ntsecapi.h)
Fungsi AuditQueryPerUserPolicy mengambil kebijakan audit per pengguna dalam satu atau beberapa subkategori kebijakan audit untuk prinsipal yang ditentukan.
Sintaks
BOOLEAN AuditQueryPerUserPolicy(
[in] const PSID pSid,
[in] const GUID *pSubCategoryGuids,
[in] ULONG dwPolicyCount,
[out] PAUDIT_POLICY_INFORMATION *ppAuditPolicy
);
Parameter
[in] pSid
Penunjuk ke struktur SID yang terkait dengan prinsipal untuk mengkueri kebijakan audit. Kebijakan per pengguna untuk SID grup saat ini tidak didukung.
[in] pSubCategoryGuids
Penunjuk ke array nilai GUID yang menentukan subkategori untuk mengkueri kebijakan audit. Untuk daftar subkataan kebijakan audit yang ditentukan, lihat Mengaudit Konstanta.
[in] dwPolicyCount
Jumlah elemen di setiap array pSubCategoryGuids dan ppAuditPolicy .
[out] ppAuditPolicy
Penunjuk ke satu buffer yang berisi array pointer untuk AUDIT_POLICY_INFORMATION struktur dan struktur itu sendiri. Struktur AUDIT_POLICY_INFORMATION menentukan kebijakan audit per pengguna untuk subkataan yang ditentukan oleh array pSubCategoryGuids .
Setelah Anda selesai menggunakan buffer ini, bebaskan dengan memanggil fungsi AuditFree .
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 |
---|---|
|
Tidak ada kebijakan audit per pengguna untuk prinsipal yang ditentukan oleh parameter pSid . |
|
Penelepon tidak memiliki hak istimewa atau hak akses yang diperlukan untuk memanggil fungsi ini. |
|
Satu atau beberapa parameter tidak valid. |
Keterangan
Agar berhasil memanggil fungsi ini, pemanggil harus memiliki SeSecurityPrivilege atau memiliki akses AUDIT_QUERY_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 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk