Fungsi AuthzInitializeObjectAccessAuditEvent2 (authz.h)

Artikel
02/23/2024

Fungsi AuthzInitializeObjectAccessAuditEvent2 mengalokasikan dan menginisialisasi handel AUTHZ_AUDIT_EVENT_HANDLE untuk digunakan dengan fungsi AuthzAccessCheck .

Sintaks

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

Parameter

[in] Flags

Bendera yang mengubah perilaku audit. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
AUTHZ_NO_ALLOC_STRINGS	Menggunakan 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.
AUTHZ_NO_FAILURE_AUDIT	Menonaktifkan pembuatan audit kegagalan.
AUTHZ_NO_SUCCESS_AUDIT	Menonaktifkan pembuatan audit keberhasilan.

[in] hAuditEventType

Dicadangkan. Parameter ini harus diatur ke NULL.

[in] szOperationType

Penunjuk ke string yang menunjukkan operasi yang akan diaudit.

[in] szObjectType

Penunjuk ke string yang menunjukkan jenis objek yang diakses.

[in] szObjectName

Penunjuk ke string yang menunjukkan nama objek yang diakses.

[in] szAdditionalInfo

Penunjuk ke string yang ditentukan oleh Resource Manager yang berisi informasi audit tambahan.

[in] szAdditionalInfo2

Penunjuk ke string yang ditentukan oleh Resource Manager yang berisi informasi audit tambahan.

[out] phAuditEvent

Penunjuk ke handel AUTHZ_AUDIT_EVENT_HANDLE yang dikembalikan.

[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	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 di Windows XP

Lihat juga

AuthzAccessCheck

Fungsi Access Control Dasar

Bagikan melalui