CLFS_MGMT_POLICY structure (clfsmgmt.h)
The CLFS_MGMT_POLICY structure specifies a Common Log File System (CLFS) management policy. The PolicyType member specifies the members used for a policy.
Syntax
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;
Members
Version
Specifies the version of the log manager headers that the application is compiled with.
Set this to CLFS_MGMT_POLICY_VERSION.
LengthInBytes
Specifies the length of the entire structure.
PolicyFlags
Reserved. Specify zero.
PolicyType
Specifies the members used for a specific policy. Valid values are specified by CLFS_MGMT_POLICY_TYPE.
PolicyParameters
Specifies the specific policy this structure describes.
PolicyParameters.MaximumSize
Specifies the maximum size of a log.
PolicyParameters.MaximumSize.Containers
Specifies the maximum size of the log as a number of containers. There is no default maximum value.
PolicyParameters.MinimumSize
Specifies the minimum size of a log.
PolicyParameters.MinimumSize.Containers
Specifies the minimum size of the log as a number of containers. The minimum size is two (2) containers.
PolicyParameters.NewContainerSize
Controls the size of a new container.
PolicyParameters.NewContainerSize.SizeInBytes
Specifies the size, in bytes, of any new containers created.
PolicyParameters.GrowthRate
Controls the rate of growth of a log. The growth rate can be either a relative percentage or an absolute number of containers added, but not both. Valid values are zero (0) and greater. Specify zero (0) to indicate that the log is not to grow in size.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Specifies the growth rate as an absolute number of containers. The default value of this member is two (2).
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Specifies the growth rate as a relative percentage. There is no default value for this member.
PolicyParameters.LogTail
Controls the amount of space that LOG_TAIL_ADVANCE_CALLBACK requests. The value is either a relative percentage or an absolute number of bytes, but not both. The value is always rounded up to the nearest container. Specify zero to indicate that no action is taken to advance the base log tail.
PolicyParameters.LogTail.MinimumAvailablePercentage
Specifies the amount of space that is requested as a percentage of the entire log. The minimum amount requested frees up space in a container.
PolicyParameters.LogTail.MinimumAvailableContainers
Specifies the amount of space that is requested as an absolute number of containers.
PolicyParameters.AutoShrink
Controls the timing of the log-shrinking feature. This value represents the percent of free space that must exist to trigger the auto-shrink operation. The log cannot be shrunk to a size smaller than the value specified by the ClfsMgmtPolicyMinimumSize policy.
PolicyParameters.AutoShrink.Percentage
Specifies the percentage to shrink the log by. There is no default value.
PolicyParameters.AutoGrow
Controls the auto-grow feature. If auto-grow is enabled, the log grows according to the value of the GrowthRate member, and is limited by the value of the MaximumSize member when the log reaches a state where one or no containers are free.
PolicyParameters.AutoGrow.Enabled
Specifies whether the auto-grow policy is enabled. Specify zero to disable the auto-grow policy. The default is disabled.
PolicyParameters.NewContainerPrefix
Controls the prefix that is given to a new container.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Specifies the length of PrefixString.
PolicyParameters.NewContainerPrefix.PrefixString[1]
Specifies the prefix string. This string should include a full path to the directory where the containers are created, and a prefix for the container name.
The default path to the container is the directory that contains the base log. The default value is "Container". The log container is created with the name <Name of Log><Default Prefix><Number>.
PolicyParameters.NewContainerSuffix
Controls the suffix that is given to a new container.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Specifies the suffix given to a new container.
PolicyParameters.NewContainerExtension
Controls the extension that is given to a new container.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Specifies the length of ExtensionString.
PolicyParameters.NewContainerExtension.ExtensionString[1]
Specifies the extension given to the container file.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 R2 [desktop apps only] |
| Header | clfsmgmt.h |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for