ClfsRemoveLogContainer 関数 (wdm.h)
ClfsRemoveLogContainer ルーチンは、CLFS ログからコンテナーを削除します。
構文
CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PUNICODE_STRING puszContainerPath,
[in] BOOLEAN fForce
);
パラメーター
[in] plfoLog
コンテナーが削除される CLFS ログを表す LOG_FILE_OBJECT 構造体へのポインター。 呼び出し元は、 以前に ClfsCreateLogFile を呼び出してこのポインターを取得しました。
[in] puszContainerPath
削除するコンテナーのパス名を指定する UNICODE_STRING 構造体へのポインター。 パス名は、ClfsAddLogContainer または ClfsAddLogContainerSet の以前の呼び出しで作成されました。 パスは、 plfoLog で表される CLFS ログのベース ログ ファイルの場所に対して絶対パスまたは相対パスにすることができます。 基本ログ ファイルに対する相対パスは、文字列リテラル (L"%BLF%\") である CLFS_CONTAINER_RELATIVE_PREFIX で始まる必要があります。 ディレクトリ "." と ".." は相対パスでは使用できません。
[in] fForce
コンテナーの削除を強制 (TRUE) または遅延 (FALSE) にするかどうかを指定するブール値。
戻り値
ClfsRemoveLogContainer は 、成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
強制コンテナーの削除 (fForce = TRUE) は、削除するコンテナーがアクティブ ログに含まれていない場合にのみ成功します。
CLFS の概念と用語の詳細については、「 共通ログ ファイル システム」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h を含む) |
| Library | Clfs.lib |
| [DLL] | Clfs.sys |
| IRQL | <= APC_LEVEL |