Fungsi EvtClearLog (winevt.h)

Artikel
03/13/2024

Menghapus semua peristiwa dari saluran yang ditentukan dan menulisnya ke file log target.

Sintaks

BOOL EvtClearLog(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    ChannelPath,
  [in, optional] LPCWSTR    TargetFilePath,
  [in]           DWORD      Flags
);

Parameter

[in, optional] Session

Handel sesi jarak jauh yang dikembalikan fungsi EvtOpenSession . Atur ke NULL untuk saluran lokal.

[in] ChannelPath

Nama saluran yang akan dihapus.

[in, optional] TargetFilePath

Jalur lengkap ke file log target yang akan menerima peristiwa. Atur ke NULL untuk menghapus file log dan tidak menyimpan peristiwa.

[in] Flags

Dicadangkan. Harus nol.

Mengembalikan nilai

Mengembalikan kode/nilai	Deskripsi
TRUE	Fungsi berhasil.
FALSE	Fungsi gagal. Gunakan fungsi GetLastError untuk mendapatkan kode kesalahan.

Keterangan

Untuk menyalin peristiwa dari saluran atau file log, panggil fungsi EvtExportLog .

Anda harus menentukan jalur absolut ke file log target; Anda tidak dapat menggunakan jalur relatif dan variabel lingkungan untuk menentukan file log target. Jalur dapat menjadi jalur Universal Naming Convention (UNC). Anda harus menggunakan .evtx sebagai ekstensi nama file.

Fungsi ini hanya memengaruhi saluran—jika saluran menggunakan autoBackup atau fileMax, fungsi ini tidak akan memengaruhi file cadangan tersebut.

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	winevt.h
Pustaka	Wevtapi.lib
DLL	Wevtapi.dll

Lihat juga

EvtArchiveExportedLog

EvtExportLog

Bagikan melalui