Fungsi DeleteLogFile (clfsw32.h)

Artikel
11/20/2024

Menandai log untuk dihapus. Log sebenarnya dihapus ketika semua handel, area marshaling, dan konteks baca ke log ditutup. Jika log adalah log fisik, kontainer yang mendasar akan dihapus.

Saat log ditandai untuk penghapusan, permintaan untuk membuka aliran log klien baru gagal.

Catatan Fungsi terkait erat DeleteLogByHandle , yang menghapus log saat diberikan handel file.

Sintaksis

CLFSUSER_API BOOL DeleteLogFile(
  [in]           LPCWSTR pszLogFileName,
  [in, optional] PVOID   pvReserved
);

Parameter

[in] pszLogFileName

Nama log.

Nama ini ditentukan saat membuat log dengan menggunakan CreateLogFile. Contoh berikut mengidentifikasi format yang akan digunakan:

log : nama log<>[::<nama aliran log>]

< nama log> sesuai dengan jalur file yang valid dalam sistem file.

< nama aliran log> adalah nama unik aliran log di log.

Untuk informasi selengkapnya, lihatJenis Log .

[in, optional] pvReserved

Parameter ini dicadangkan dan harus diatur ke NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol (0). Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError. Daftar berikut mengidentifikasi kemungkinan kode kesalahan:

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Platform Target	Windows
Header	clfsw32.h
Pustaka	Clfsw32.lib
DLL	Clfsw32.dll

Lihat juga

Fungsi Sistem File Log Umum

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES

Bagikan melalui