структура 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". Контейнер журнала создается с именем <Имя номера> префикса><журнала><по умолчанию.
PolicyParameters.NewContainerSuffix
Управляет суффиксом, который присваивается новому контейнеру.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Задает суффикс, заданный новому контейнеру.
PolicyParameters.NewContainerExtension
Управляет расширением, предоставленным новому контейнеру.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Указывает длину ExtensionString.
PolicyParameters.NewContainerExtension.ExtensionString[1]
Указывает расширение, предоставленное файлу контейнера.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 R2 [только классические приложения] |
| Верхняя часть | clfsmgmt.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по