ClfsCloseAndResetLogFile 関数 (wdm.h)

ClfsCloseAndResetLogFile ルーチンは、指定されたログ ファイル オブジェクトへのすべての参照を解放し、関連付けられているストリームにリセットのマークを付けます。

構文

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

パラメーター

[in] plfoLog

参照が解放される LOG_FILE_OBJECT 構造体へのポインター。 呼び出し元は、 以前に ClfsCreateLogFile を呼び出してこのポインターを取得しました。

戻り値

ClfsCloseAndResetLogFile は 、成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。

注釈

ClfsCloseAndResetLogFile は 、CLFS によって取得されたすべての参照を、指定されたログ ファイル オブジェクトに解放します。 通常、クライアントはログ ファイル オブジェクトへの追加の参照を取得しません。 ただし、クライアントが追加の参照を取得した場合は、それらを解放するのはクライアントの責任です。

ClfsCloseAndResetLogFile により、指定されたログ ファイル オブジェクトの参照カウントが 0 にドロップされ、その時点でログ ファイル オブジェクトが閉じられます (つまり、メモリの割り当てが解除されます)。 ただし、同じストリームを表す他のログ ファイル オブジェクトが存在する可能性があるため、ログ ファイル オブジェクトによって表されるストリームがリセットされない可能性があります。 ストリームを表すすべてのログ ファイル オブジェクトが閉じられた後 ( ClfsCloseLogFileObject の呼び出しなど) 後、ストリームはリセットされます。

リセット ストリームは、レコードが書き込まれたことがない新しく作成されたストリームのようなものです。

このルーチンから戻った場合、 plfoLog は無効です。

ClfsCloseAndResetLogFile は、特定のストリームに対して最大 124 回呼び出すことができます。

CLFS の概念と用語の詳細については、「 共通ログ ファイル システム」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	wdm.h (Wdm.h を含む)
Library	Clfs.lib
[DLL]	Clfs.sys
IRQL	<= APC_LEVEL

こちらもご覧ください

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile