Fungsi AuthzInitializeObjectAccessAuditEvent (authz.h)

Artikel
02/26/2024

Fungsi AuthzInitializeObjectAccessAuditEvent menginisialisasi audit untuk objek.

Sintaks

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Parameter

[in] Flags

Memodifikasi audit. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
AUTHZ_NO_SUCCESS_AUDIT	Menonaktifkan pembuatan audit keberhasilan.
AUTHZ_NO_FAILURE_AUDIT	Menonaktifkan pembuatan audit kegagalan.
AUTHZ_NO_ALLOC_STRINGS	Gunakan pointer ke string yang diteruskan alih-alih mengalokasikan memori dan menyalin string. Aplikasi panggilan harus memastikan bahwa memori yang diteruskan tetap valid selama pemeriksaan akses.

[in] hAuditEventType

Dicadangkan. Parameter ini harus diatur ke NULL.

[in] szOperationType

String yang menunjukkan operasi yang akan diaudit.

[in] szObjectType

String yang menunjukkan jenis objek yang diakses.

[in] szObjectName

String menunjukkan nama objek yang sedang diakses.

[in] szAdditionalInfo

String, yang ditentukan oleh Resource Manager, untuk informasi audit tambahan.

[out] phAuditEvent

Pointer yang menerima struktur AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Harus diatur ke nol.

...

Parameter tambahan.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

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

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	authz.h
Pustaka	Authz.lib
DLL	Authz.dll
Redistribusi	Paket Alat Administrasi Windows Server 2003 pada Windows XP

Lihat juga

AuthzAccessCheck

Fungsi Access Control Dasar

Bagikan melalui