Fungsi ObjectCloseAuditAlarmA (winbase.h)

Artikel
03/08/2023

Fungsi ObjectCloseAuditAlarm menghasilkan pesan audit di log peristiwa keamanan saat handel ke objek privat dihapus. Alarm saat ini tidak didukung.

Sintaks

BOOL ObjectCloseAuditAlarmA(
  [in] LPCSTR SubsystemName,
  [in] LPVOID HandleId,
  [in] BOOL   GenerateOnClose
);

Parameter

[in] SubsystemName

Penunjuk ke string yang dihentikan null yang menentukan nama subsistem yang memanggil fungsi. String ini muncul dalam pesan audit apa pun yang dihasilkan fungsi.

[in] HandleId

Nilai unik yang mewakili handel klien ke objek . Nilai ini harus sama yang diteruskan ke fungsi AccessCheckAndAuditAlarm atau ObjectOpenAuditAlarm .

[in] GenerateOnClose

Menentukan bendera yang diatur oleh panggilan ke fungsi AccessCheckAndAuditAlarm atau ObjectCloseAuditAlarm saat handel objek dibuat. Jika bendera ini TRUE, fungsi akan menghasilkan pesan audit. Jika FALSE, fungsi tidak menghasilkan pesan audit.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ObjectCloseAuditAlarm mengharuskan aplikasi panggilan mengaktifkan hak istimewa SE_AUDIT_NAME. Pengujian untuk hak istimewa ini selalu dilakukan terhadap token utama proses panggilan, memungkinkan proses panggilan untuk meniru klien.

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	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll