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 で使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wdm.h (Wdm.h を含む)
ライブラリ	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

関連項目

ClfsCloseLogFileObject の

ClfsDeleteLogByPointer の

ClfsDeleteLogFile の