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

予約済み。 0 を指定します。

PolicyType

特定のポリシーに使用されるメンバーを指定します。 有効な値は 、CLFS_MGMT_POLICY_TYPEによって指定されます。

PolicyParameters

この構造で説明する特定のポリシーを指定します。

PolicyParameters.MaximumSize

ログの最大サイズを指定します。

PolicyParameters.MaximumSize.Containers

ログの最大サイズをコンテナーの数として指定します。 既定の最大値はありません。

PolicyParameters.MinimumSize

ログの最小サイズを指定します。

PolicyParameters.MinimumSize.Containers

ログの最小サイズをコンテナーの数として指定します。 最小サイズは、2 つのコンテナーです。

PolicyParameters.NewContainerSize

新しいコンテナーのサイズを制御します。

PolicyParameters.NewContainerSize.SizeInBytes

作成された新しいコンテナーのサイズをバイト単位で指定します。

PolicyParameters.GrowthRate

ログの増加率を制御します。 増加率には、相対的なパーセンテージまたは追加されたコンテナーの絶対数を指定できますが、両方を指定することはできません。 有効な値は 0 (0) 以上です。 ログのサイズが拡大しないことを示すには、0 (0) を指定します。

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

コンテナーの絶対数として増加率を指定します。 このメンバーの既定値は 2 です。

PolicyParameters.GrowthRate.RelativeGrowthPercentage

相対的な割合として増加率を指定します。 このメンバーの既定値はありません。

PolicyParameters.LogTail

要求を LOG_TAIL_ADVANCE_CALLBACK する領域の量を制御します。 値は相対パーセンテージまたは絶対バイト数ですが、両方ではありません。 値は常に最も近いコンテナーに切り上げられます。 ベース ログ末尾を進めるためのアクションが実行されていないことを示すには、0 を指定します。

PolicyParameters.LogTail.MinimumAvailablePercentage

ログ全体に対する割合として要求される領域の量を指定します。 要求された最小量は、コンテナー内の領域を解放します。

PolicyParameters.LogTail.MinimumAvailableContainers

コンテナーの絶対数として要求される領域の量を指定します。

PolicyParameters.AutoShrink

ログ圧縮機能のタイミングを制御します。 この値は、自動圧縮操作をトリガーするために存在する必要がある空き領域の割合を表します。 ログを ClfsMgmtPolicyMinimumSize ポリシーで指定された値より小さいサイズに縮小することはできません。

PolicyParameters.AutoShrink.Percentage

ログを縮小する割合を指定します。 既定値はありません。

PolicyParameters.AutoGrow

自動拡張機能を制御します。 自動拡張が有効になっている場合、ログは GrowthRate メンバーの値に従って増加し、ログが空きコンテナーがない状態に達したときに MaximumSize メンバーの値によって制限されます。

PolicyParameters.AutoGrow.Enabled

自動拡張ポリシーを有効にするかどうかを指定します。 自動拡張ポリシーを無効にするには、0 を指定します。 既定では無効になっています。

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]

コンテナー ファイルに指定された拡張子を指定します。

要件

こちらもご覧ください

CLFS_MGMT_POLICY_TYPE