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 |