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 (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 |