Fungsi ClfsDeleteLogFile (wdm.h)

  • Artikel

Rutinitas ClfsDeleteLogFile menandai aliran CLFS untuk penghapusan.

Sintaks

CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
  [in]           PUNICODE_STRING puszLogFileName,
                 PVOID           pvReserved,
  [in]           ULONG           fLogOptionFlag,
  [in, optional] PVOID           pvContext,
  [in]           ULONG           cbContext
);

Parameter

[in] puszLogFileName

Penunjuk ke struktur UNICODE_STRING yang memasok nama aliran CLFS yang akan dihapus.

Jika aliran yang akan dihapus adalah satu-satunya aliran log khusus, namanya memiliki log formulir:nama log fisik, di mana nama log fisik adalah nama jalur log fisik pada sistem file yang mendasar.

Jika aliran yang akan dihapus adalah salah satu aliran log multipleks, namanya memiliki nama log:log fisik::nama stream, di mana nama log fisik adalah nama jalur log fisik pada sistem file yang mendasar dan nama aliran adalah nama unik aliran yang akan dihapus.

pvReserved

Dicadangkan.

[in] fLogOptionFlag

Nilai yang menunjukkan hubungan antara CLFS dan komponen yang menghapus log. Untuk daftar nilai yang mungkin, lihat deskripsi parameter fLogOptionFlag dari rutinitas ClfsCreateLogFile .

[in, optional] pvContext

Penunjuk ke konteks. Cara konteks ditafsirkan tergantung pada nilai yang diteruskan dalam fLogOptionFlag.

[in] cbContext

Ukuran, dalam byte, dari konteks yang ditujukkan oleh pvContext. Jika pvContext bukan NULL, parameter ini harus lebih besar dari nol.

Mengembalikan nilai

ClfsDeleteLogFile mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Common Log File System (CLFS) menggunakan struktur LOG_FILE_OBJECT untuk mewakili log. Fungsi ClfsCreateLogFile mengembalikan pointer ke LOG_FILE_OBJECT, yang kemudian diteruskan klien ke fungsi CLFS lainnya.

Klien CLFS tidak secara langsung mengakses anggota struktur LOG_FILE_OBJECT. Untuk informasi tentang anggota, lihat FILE_OBJECT.

ClfsDeleteLogFile menandai aliran untuk dihapus tetapi tidak menutup objek file log apa pun yang saat ini terbuka. Untuk menutup objek file log, panggil ClfsCloseLogFileObject. Aliran yang ditandai untuk penghapusan dihapus setelah semua objek file log yang terkait dengan aliran ditutup.

Aliran CLFS yang ditandai untuk penghapusan akan menolak permintaan berikutnya untuk membuka aliran.

Nama log CLFS fisik tidak menyertakan ekstensi .blf.

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Sistem File Log Umum.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h)
Pustaka Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Lihat juga

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer