通过

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

指向 LOG_FILE_OBJECT 结构的指针，该结构表示要添加或删除容器的通用日志文件系统 (CLFS) 日志或日志中的流。 此参数的值是通过调用 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 管理库例程