SetLogFileSizeWithPolicy 函数 (clfsmgmtw32.h)

  • 项目

根据已安装策略的状态在日志中添加或删除容器。

语法

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

参数

[in] hLog

日志的句柄。

[in] pDesiredSize

指向值的指针，该值指定请求的日志大小，表示为以下值之一。 有关实际结果大小，请参阅 pResultingSize 参数。

值 含义
0
 强制实施最小大小策略。

如果未安装最小大小策略，则会发生以下任一情况：

  • 如果日志的容器少于两个，日志将扩展到两个容器的大小。
  • 如果日志具有两个或更多个容器，则不会进行更改，并且函数调用会成功。

如果安装了最小大小策略，则会发生以下任一情况：

  • 如果日志的容器数少于最小大小策略指定的最小容器数，则日志将扩展到策略指定的最小容器数。
  • 如果日志的容器数大于或等于最小大小策略指定的最小容器数，则不会进行更改，并且函数调用成功且不会出错。

有关详细信息，请参阅 InstallLogPolicy。
1
 无效值;函数调用失败并 出现ERROR_INVALID_PARAMETER。
2–1023
 日志的所需大小，表示为容器数。

如果此数目小于已安装策略指定的最小容器数，则函数调用将失败并 ERROR_COULD_NOT_RESIZE_LOG。

如果此数目大于已安装策略指定的最大容器数，日志将仅扩展到策略指定的最大容器数，并且函数成功且没有错误。
1024–MAXULONGLONG
 如果未安装最大大小策略，则函数调用将失败并 ERROR_LOG_POLICY_CONFLICT。

如果安装了最大大小策略，日志将扩展到由最大大小策略指定的最大容器数，并且函数成功且没有错误。

[out] pResultingSize

指向有效 ULONGLONG 数据变量的指针，在成功时接收大小调整后的日志中的容器数。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 若要获得更多的错误信息，请调用 GetLastError 函数。

备注

容器是使用与 .blf 文件相同的安全属性创建的，是在应用程序的上下文中创建的，而不是 .blf 文件所有者的上下文。 有关 .blf 文件的详细信息，请参阅 日志类型。 如果删除了容器，则会使用调用应用程序的安全上下文将其删除。

示例

有关使用此函数的示例，请参阅 创建日志文件。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 R2 [仅限桌面应用]
目标平台 Windows
标头 clfsmgmtw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

另请参阅

创建日志文件

InstallLogPolicy

日志类型