CLFS_MGMT_POLICY 結構 (wdm.h)

發行項
02/27/2024

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 的原則。您可以在記錄檔存在之後變更其他原則。