структура 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) контейнера.

PolicyParameters.NewContainerSize

Управляет размером нового контейнера.

PolicyParameters.NewContainerSize.SizeInBytes

Указывает размер всех созданных контейнеров (в байтах).

PolicyParameters.GrowthRate

Управляет скоростью роста журнала. Темпы роста могут быть либо относительными процентами, либо абсолютным числом добавленных контейнеров, но не обоими. Допустимые значения: ноль (0) и больше. Укажите ноль (0), чтобы указать, что размер журнала не должен увеличиваться.

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

Задает скорость роста в виде абсолютного числа контейнеров. Значение этого элемента по умолчанию — два (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". Контейнер журнала создается с именем <Имя номера> префикса><журнала><по умолчанию.

Примечание Значение Number определяется в общей файловой системе журналов <>(CLFS).

 

PolicyParameters.NewContainerSuffix

Управляет суффиксом, который присваивается новому контейнеру.

PolicyParameters.NewContainerSuffix.NextContainerSuffix

Задает суффикс, заданный новому контейнеру.

PolicyParameters.NewContainerExtension

Управляет расширением, предоставленным новому контейнеру.

PolicyParameters.NewContainerExtension.ExtensionLengthInBytes

Указывает длину ExtensionString.

PolicyParameters.NewContainerExtension.ExtensionString[1]

Указывает расширение, предоставленное файлу контейнера.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 R2 [только классические приложения]
Верхняя часть	clfsmgmt.h

См. также раздел

CLFS_MGMT_POLICY_TYPE