Fungsi AuthzReportSecurityEvent (authz.h)

Artikel
02/26/2024

Fungsi AuthzReportSecurityEvent menghasilkan audit keamanan untuk sumber peristiwa keamanan terdaftar.

Audit untuk kategori peristiwa akses objek harus diaktifkan untuk fungsi AuthzReportSecurityEvent untuk menghasilkan audit keamanan. Jenis audit yang tersedia ditentukan dalam enumerasi AUDIT_PARAM_TYPE .

Sintaks

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Parameter

[in] dwFlags

Bendera yang menentukan jenis audit yang dihasilkan. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
APF_AuditFailure 0x00000000	Audit kegagalan dihasilkan.
APF_AuditSuccess 0x00000001	Audit keberhasilan dihasilkan.

[in, out] hEventProvider

Handel ke sumber peristiwa keamanan terdaftar untuk digunakan untuk audit.

[in] dwAuditId

Pengidentifikasi audit.

[in, optional] pUserSid

Penunjuk ke pengidentifikasi keamanan (SID) yang akan dicantumkan sebagai sumber audit di log peristiwa.

[in] dwCount

Jumlah pasangan jenis/nilai AuditParamFlag yang muncul di bagian argumen variabel yang mengikuti parameter ini.

...

Daftar pasangan jenis/nilai AuditParamFlag yang memberikan informasi tambahan tentang peristiwa tersebut.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	authz.h
Pustaka	Authz.lib
DLL	Authz.dll
Redistribusi	Paket Alat Administrasi Windows Server 2003 pada Windows XP

Lihat juga

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams

Bagikan melalui