CLFS_MGMT_POLICY 结构 (clfsmgmt.h)
CLFS_MGMT_POLICY 结构指定通用日志文件系统 (CLFS) 管理策略。 PolicyType 成员指定用于策略的成员。
语法
typedef struct _CLFS_MGMT_POLICY {
ULONG Version;
ULONG LengthInBytes;
ULONG PolicyFlags;
CLFS_MGMT_POLICY_TYPE PolicyType;
union {
struct {
ULONG Containers;
} MaximumSize;
struct {
ULONG Containers;
} MinimumSize;
struct {
ULONG SizeInBytes;
} NewContainerSize;
struct {
ULONG AbsoluteGrowthInContainers;
ULONG RelativeGrowthPercentage;
} GrowthRate;
struct {
ULONG MinimumAvailablePercentage;
ULONG MinimumAvailableContainers;
} LogTail;
struct {
ULONG Percentage;
} AutoShrink;
struct {
ULONG Enabled;
} AutoGrow;
struct {
USHORT PrefixLengthInBytes;
WCHAR PrefixString[1];
} NewContainerPrefix;
struct {
ULONGLONG NextContainerSuffix;
} NewContainerSuffix;
struct {
USHORT ExtensionLengthInBytes;
WCHAR ExtensionString[1];
} NewContainerExtension;
} PolicyParameters;
} CLFS_MGMT_POLICY, *PCLFS_MGMT_POLICY;
成员
Version
指定编译应用程序的日志管理器标头的版本。
将此设置为 CLFS_MGMT_POLICY_VERSION。
LengthInBytes
指定整个结构的长度。
PolicyFlags
保留。 指定零。
PolicyType
指定用于特定策略的成员。 有效值由 CLFS_MGMT_POLICY_TYPE 指定。
PolicyParameters
指定此结构描述的特定策略。
PolicyParameters.MaximumSize
指定日志的最大大小。
PolicyParameters.MaximumSize.Containers
将日志的最大大小指定为多个容器。 没有默认的最大值。
PolicyParameters.MinimumSize
指定日志的最小大小。
PolicyParameters.MinimumSize.Containers
将日志的最小大小指定为多个容器。 最小大小为 2 (2) 容器。
PolicyParameters.NewContainerSize
控制新容器的大小。
PolicyParameters.NewContainerSize.SizeInBytes
指定创建的任何新容器的大小（以字节为单位）。
PolicyParameters.GrowthRate
控制日志的增长速度。 增长率可以是相对百分比或添加的容器的绝对数，但不能同时为两者。 有效值为零 (0) 及更大。 指定零 (0) 以指示日志大小不会增长。
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
将增长率指定为容器的绝对数。 此成员的默认值为两 (2) 。
PolicyParameters.GrowthRate.RelativeGrowthPercentage
将增长率指定为相对百分比。 此成员没有默认值。
PolicyParameters.LogTail
控制 LOG_TAIL_ADVANCE_CALLBACK 请求的空间量。 该值是相对百分比或绝对字节数，但不是两者兼而有之。 值始终向上舍入到最近的容器。 指定零以指示不执行任何操作来推进基本日志尾部。
PolicyParameters.LogTail.MinimumAvailablePercentage
指定请求的空间量（占整个日志的百分比）。 请求的最小数量会释放容器中的空间。
PolicyParameters.LogTail.MinimumAvailableContainers
指定作为绝对容器数请求的空间量。
PolicyParameters.AutoShrink
控制日志收缩功能的计时。 此值表示触发自动收缩操作必须存在的可用空间的百分比。 日志不能收缩到小于 ClfsMgmtPolicyMinimumSize 策略指定的值的大小。
PolicyParameters.AutoShrink.Percentage
指定要收缩日志的百分比。 没有默认值。
PolicyParameters.AutoGrow
控制自动增长功能。 如果启用了自动增长，则日志会根据 GrowthRate 成员的值增长，并且当日志达到一个或没有任何容器可用状态时，将受到 MaximumSize 成员的值的限制。
PolicyParameters.AutoGrow.Enabled
指定是否启用自动增长策略。 指定零可禁用自动增长策略。 默认为禁用。
PolicyParameters.NewContainerPrefix
控制为新容器提供的前缀。
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
指定 PrefixString 的长度。
PolicyParameters.NewContainerPrefix.PrefixString[1]
指定前缀字符串。 此字符串应包含创建容器的目录的完整路径，以及容器名称的前缀。
容器的默认路径是包含基本日志的目录。 默认值为“Container”。 创建日志容器时，名称 <为日志><默认前缀><编号>。
PolicyParameters.NewContainerSuffix
控制分配给新容器的后缀。
PolicyParameters.NewContainerSuffix.NextContainerSuffix
指定为新容器提供的后缀。
PolicyParameters.NewContainerExtension
控制提供给新容器的扩展。
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
指定 ExtensionString 的长度。
PolicyParameters.NewContainerExtension.ExtensionString[1]
指定为容器文件提供的扩展名。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 R2 [仅限桌面应用] |
| 标头 | clfsmgmt.h |