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 |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示