CLFS_MGMT_POLICY 結構 (wdm.h)
CLFS_MGMT_POLICY結構會保留管理 CLFS 記錄的原則描述。
語法
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 結構的版本。 將此設定為 CLFS_MGMT_POLICY_VERSION。
LengthInBytes
CLFS_MGMT_POLICY 結構的長度。
PolicyFlags
套用至 CLFS_MGMT_POLICY 結構之這個實例的旗標。 針對此版本實作的唯一旗標是 LOG_POLICY_OVERWRITE，這表示安裝原則時，如果這類原則已經存在，則會取代相同類型的原則。
PolicyType
CLFS_MGMT_POLICY_TYPE 列舉的值 ，提供 CLFS_MGMT_POLICY 結構的這個實例類型。
PolicyParameters
提供這個 CLFS_MGMT_POLICY 結構實例詳細信息的聯集。
PolicyParameters.MaximumSize
結構，提供 其 PolicyType 為 ClfsMgmtPolicyMaximumSize 之原則的詳細資訊。
PolicyParameters.MaximumSize.Containers
記錄將使用的容器數目上限。
PolicyParameters.MinimumSize
結構，提供 其 PolicyType 為 ClfsMgmtPolicyMinimumSize 之原則的詳細資訊。
PolicyParameters.MinimumSize.Containers
記錄將使用的容器數目下限。
PolicyParameters.NewContainerSize
結構，提供 其 PolicyType 為 ClfsMgmtPolicyNewContainerSize 之原則的詳細資訊。
PolicyParameters.NewContainerSize.SizeInBytes
每個記錄容器的大小。
PolicyParameters.GrowthRate
結構，提供 其 PolicyType 為 ClfsMgmtPolicyGrowthRate 之原則的詳細資訊。
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
當記錄檔的大小增加時，應該加入的容器數目。 如果 RelativeGrowthPercentage 成員為非零， 則 AbsoluteGrowthInContainers 必須為零。
PolicyParameters.GrowthRate.RelativeGrowthPercentage
當記錄成長時，記錄檔大小應該增加的百分比，以介於零到100之間的數位表示。 例如，如果記錄包含 32 個容器， 而 RelativeGrowthPercentage 為十，則當記錄需要成長時，它會成長三個 (32 * 10%，捨入到最接近的整數) 容器。 如果 AbsoluteGrowthInContainers 成員為非零， 則 RelativeGrowthPercentage 必須為零。
PolicyParameters.LogTail
結構，提供 其 PolicyType 為 ClfsMgmtPolicyLogTail 之原則的詳細資訊。
PolicyParameters.LogTail.MinimumAvailablePercentage
當 CLFS 管理通知用戶端移動其記錄尾端時，它會指定將尾移至至少保留 記錄的 MinimumAvailablePercentage 百分比的 LSN。 如果 MinimumAvailableContainers 成員為非零， 則 MinimumAvailablePercentage 必須為零。
PolicyParameters.LogTail.MinimumAvailableContainers
當 CLFS 管理通知用戶端行動其記錄尾端時，它會指定將尾移至至少保留 MinimumAvailableContainers 容器的 LSN。 如果 MinimumAvailablePercentage 成員為非零， 則 MinimumAvailableContainers 必須為零。
PolicyParameters.AutoShrink
結構，提供 其 PolicyType 為 ClfsMgmtPolicyAutoShrink 之原則的詳細資訊。
PolicyParameters.AutoShrink.Percentage
當記錄檔中的可用空間百 分比達到 Percentage 時，記錄將會壓縮。 百分比以介於 0 到 100 之間的數位表示，因此 25 的值表示為 25%。
PolicyParameters.AutoGrow
結構，提供 其 PolicyType 為 ClfsMgmtPolicyAutoGrow 之原則的詳細資訊。
PolicyParameters.AutoGrow.Enabled
數值，決定是否啟用自動記錄成長。 任何非零值都能夠自動成長。
PolicyParameters.NewContainerPrefix
結構，提供 其 PolicyType 為 ClfsMgmtPolicyNewContainerPrefix 之原則的詳細資訊。
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
PrefixString 成員的長度，以位元組為單位。
PolicyParameters.NewContainerPrefix.PrefixString[1]
寬字元字串，其中包含記錄容器所在目錄的完整路徑，以及將做為記錄中每個容器之檔名一部分的前置詞。
PolicyParameters.NewContainerSuffix
結構，提供 其 PolicyType 為 ClfsMgmtPolicyNewContainerSuffix 之原則的詳細資訊。
PolicyParameters.NewContainerSuffix.NextContainerSuffix
要作為記錄中下一個容器之檔名後綴的數位。 若要形成檔名，數位會轉換成十進位數的字串，並附加至前置詞字串。 每個後續容器的檔名會遞增數位。
PolicyParameters.NewContainerExtension
結構，提供 其 PolicyType 為 ClfsMgmtPolicyNewContainerExtension 之原則的詳細資訊。
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
ExtensionString 成員的長度，以位元組為單位。
PolicyParameters.NewContainerExtension.ExtensionString[1]
寬字元字串，其中包含記錄中每個容器之檔名的擴展名。 容器檔名是使用 [prefix][suffix][.extension] 格式所建置。 擴充功能是選擇性的。 預設延伸模組是空字串。
備註
CLFS_MGMT_POLICY結構解譯的方式取決於結構所保留的原則類型。
您可以 提供原則 來指定記錄的管理方式。 每個原則都是 CLFS_MGMT_POLICY 結構的實例，但結構會根據原則類型以不同的方式解譯。 CLFS 會使用您在原則中提供的資訊來量身打造其管理記錄的方式。
當您建立其 PolicyType 為 ClfsMgmtPolicyNewContainerPrefix的CLFS_MGMT_POLICY結構時，請務必配置足夠的空間來保存 PolicyParameters.NewContainerPrefix.PrefixString 字串。
您只能在記錄檔中有任何容器之前，先安裝 PolicyType 值中指定的原則類型為 ClfsMgmtPolicyNewContainerSize 的原則。 您可以在記錄檔存在之後變更其他原則。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |