ClfsMgmtSetLogFileSizeAsClient 関数 (wdm.h)
ClfsMgmtSetLogFileSizeAsClient ルーチンは、クライアント ログにコンテナーを追加するか、クライアント ログからコンテナーを削除することで、ログ ファイルのサイズを設定します。
構文
CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
[in] PLOG_FILE_OBJECT LogFile,
[in, optional] CLFS_MGMT_CLIENT ClientCookie,
[in] PULONGLONG NewSizeInContainers,
[out, optional] PULONGLONG ResultingSizeInContainers,
[in, optional] PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
[in, optional] PVOID CompletionRoutineData
);
パラメーター
[in] LogFile
共通ログ ファイル システム (CLFS) ログを表す LOG_FILE_OBJECT 構造体、またはコンテナーが追加または削除されるログ内のストリームへのポインター。 このパラメーターの値は、 ClfsCreateLogFile ルーチンの呼び出しによって取得されます。
[in, optional] ClientCookie
クライアント提供の Cookie へのポインター。 このパラメーターの値は、ClfsMgmtRegisterManagedClient ルーチンの呼び出しによって取得されるCLFS_MGMT_CLIENT構造体である必要があります。
[in] NewSizeInContainers
コンテナーの数で表される、ログの目的のサイズ。 ログ ファイルには、最大 1,024 個のコンテナーを使用できます。
[out, optional] ResultingSizeInContainers
コンテナーの数で表されるログの実際のサイズ。
[in, optional] CompletionRoutine
使用しません。
[in, optional] CompletionRoutineData
使用しません。
戻り値
ClfsMgmtSetLogFileSizeAsClient ルーチンは NTSTATUS 値を返します。
リターン コード | 説明 |
---|---|
|
ログ ファイルのサイズが設定されています。 |
|
LogFile パラメーターの値が NULL であるか、NewSizeInContainers パラメーターの内容が 1 です。 |
|
NewSizeInContainers パラメーターの値は NULL です。 |
|
ログにインストールされた一連のポリシーが無効です。 これは、無効な ClfsMgmtPolicyAutoShrink ポリシーまたは ClfsMgmtPolicyMaximumSize ポリシーが原因である可能性があります。 |
|
CLFS 管理では、 NewSizeInContainers の値に達するのに十分なコンテナーを削除できませんでした。 |
|
指定したログのポリシーによって、操作が完了できませんでした。 これは、CLFS 管理が 、NewSizeInContainers の値に達するのに十分なコンテナーをログに追加できなかった場合に発生する可能性があります。 これは、クライアントが設定したポリシーとの競合が原因である可能性があります。 |
このルーチンは、他の NTSTATUS 値も返す場合があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
対象プラットフォーム | デスクトップ |
Header | wdm.h |
[DLL] | Clfs.sys |