ClfsRemoveLogContainerSet 関数 (wdm.h)

ClfsRemoveLogContainerSet ルーチンは、CLFS ログからコンテナーのセットをアトミックに削除します。

構文

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

パラメーター

[in] plfoLog

コンテナーの削除元となる CLFS ログを表す LOG_FILE_OBJECT 構造体へのポインター。 呼び出し元は、 以前に ClfsCreateLogFile を呼び出してこのポインターを取得しました。

[in] cContainers

セット内のコンテナーの数。 これは rgwszContainerPath 配列内の要素の数です。

[in] rgwszContainerPath

削除するコンテナーのパス名を指定する、 UNICODE_STRING 構造体の配列へのポインター。 配列内の要素の数は cContainers によって指定されます。 指定されたパスは、 plfoLog で表される CLFS ログの基本ログ ファイルの場所に対して絶対パスまたは相対パスにすることができます。 基本ログ ファイルに対する相対パスは、文字列リテラル (L"%BLF%\") である CLFS_CONTAINER_RELATIVE_PREFIX で始まる必要があります。 ディレクトリ "." と ".." は相対パスでは使用できません。

[in] fForce

コンテナーの削除を強制 (TRUE) または遅延 (FALSE) にするかどうかを指定するブール値。

戻り値

ClfsRemoveLogContainerSet は、成功した場合に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

こちらもご覧ください

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING