Fungsi ClfsCloseAndResetLogFile (wdm.h)

Rutinitas ClfsCloseAndResetLogFile merilis semua referensi ke objek file log tertentu dan menandai aliran terkait untuk direset.

Sintaks

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

Parameter

[in] plfoLog

Penunjuk ke struktur LOG_FILE_OBJECT yang referensinya akan dirilis. Pemanggil sebelumnya mendapatkan pointer ini dengan memanggil ClfsCreateLogFile.

Nilai kembali

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

Keterangan

ClfsCloseAndResetLogFile merilis semua referensi, yang diperoleh oleh CLFS, ke objek file log yang ditentukan. Biasanya, klien tidak akan memperoleh referensi tambahan apa pun ke objek file log. Namun, jika klien telah mendapatkan referensi tambahan, klien bertanggung jawab untuk melepaskannya.

ClfsCloseAndResetLogFile menyebabkan jumlah referensi objek file log yang ditentukan turun ke nol, pada saat itu objek file log ditutup (artinya, memorinya dibatalkan alokasinya). Aliran yang diwakili oleh objek file log mungkin tidak direset, namun, karena mungkin ada objek file log lain yang mewakili aliran yang sama. Aliran diatur ulang setelah semua objek file log yang mewakili aliran ditutup (misalnya dengan panggilan ke ClfsCloseLogFileObject).

Aliran reset seperti aliran yang baru dibuat yang belum pernah ada rekaman yang ditulis ke dalamnya.

Saat kembali dari rutinitas ini, plfoLog tidak valid.

Anda dapat memanggil ClfsCloseAndResetLogFile paling banyak 124 kali untuk streaming tertentu.

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

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile