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 文件的详细信息，请参阅日志类型。如果删除了容器，则会使用调用应用程序的安全上下文将其删除。

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