次の方法で共有

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 値を返します。

リターン コード 形容
STATUS_SUCCESS
 ログ ファイルのサイズが設定されています。
STATUS_INVALID_PARAMETER_1
 LogFile パラメーターの値が NULL 、または NewSizeInContainers パラメーターの内容が 1 です。
STATUS_INVALID_PARAMETER_2
 NewSizeInContainers パラメーターの値は NULL です。
STATUS_LOG_POLICY_INVALID
 ログにインストールされている一連のポリシーが無効です。 これは、無効な ClfsMgmtPolicyAutoShrink ポリシーまたは clfsMgmtPolicyMaximumSize ポリシー が原因である可能性があります。
STATUS_COULD_NOT_RESIZE_LOG
 CLFS 管理では、NewSizeInContainers の値に達するのに十分なコンテナー削除できませんでした。
STATUS_LOG_POLICY_CONFLICT
 指定したログのポリシーによって、操作が完了できませんでした。 これは、CLFS 管理が、NewSizeInContainersの値に到達するのに十分なコンテナーをログに追加できなかった場合に発生する可能性があります。 これは、クライアントが設定したポリシーとの競合が原因である可能性があります。
 

このルーチンは、他の NTSTATUS 値返す場合もあります。

必要条件

要件 価値
サポートされる最小クライアント Windows 7 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h
DLL Clfs.sys

関連項目

CLFS 管理ライブラリー・ルーチン の