通过

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 管理库例程