структура TXFS_MODIFY_RM (winioctl.h)
[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для работы с которыми был разработан TxF, можно реализовать с помощью более простых и доступных методов. Кроме того, TxF может быть недоступен в будущих версиях Microsoft Windows. Дополнительные сведения и альтернативы TxF см. в разделе Альтернативы использованию транзакционной NTFS.]
Содержит сведения, необходимые при изменении параметров журнала и режима ведения журнала для дополнительного диспетчера ресурсов.
Синтаксис
typedef struct _TXFS_MODIFY_RM {
DWORD Flags;
DWORD LogContainerCountMax;
DWORD LogContainerCountMin;
DWORD LogContainerCount;
DWORD LogGrowthIncrement;
DWORD LogAutoShrinkPercentage;
DWORDLONG Reserved;
WORD LoggingMode;
} TXFS_MODIFY_RM, *PTXFS_MODIFY_RM;
Члены
Flags
Параметры журнала, которые необходимо задать.
Этот элемент может иметь одно или несколько из следующих значений.
| Значение | Значение |
|---|---|
|
Если этот флаг установлен, используется элемент LoggingMode этой структуры. Если флаг не установлен, элемент LoggingMode игнорируется. |
|
Если этот флаг установлен, RM предписывается переименовать себя (создать новый GUID). |
|
Если этот флаг установлен, используется член LogContainerCountMax . Если флаг не установлен, элемент LogContainerCountMax игнорируется. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Если этот флаг установлен, используется элемент LogContainerCountMin . Если флаг не установлен, элемент LogContainerCountMin игнорируется. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Если этот флаг установлен, используется элемент LogGrowthIncrement . Если флаг не задан, элемент LogGrowthIncrement игнорируется. Этот флаг указывает, что размер журнала должен увеличиваться на количество контейнеров, указанное в элементе LogGrowthIncrement . Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Если этот флаг установлен, используется элемент LogGrowthIncrement . Если флаг не задан, элемент LogGrowthIncrement игнорируется. Этот флаг указывает, что размер журнала должен увеличиваться на процент от размера журнала, указанного в элементе LogGrowthIncrement . Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Если этот флаг установлен, используется элемент LogAutoShrinkPercentage . Если флаг не установлен, параметр LogAutoShrinkPercentage игнорируется. |
|
Если этот флаг установлен, RM предписывается разрешить размер своего журнала без границ. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Если этот флаг установлен, RM предписывается разрешить журналу сжимать журнал только до двух контейнеров. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Если этот флаг установлен, журналу предписывается немедленно увеличить его размер до размера, указанного в LogContainerCount. Если флаг не задан, logContainerCount игнорируется. |
|
Если этот флаг установлен, журналу предписывается немедленно уменьшить его размер до размера, указанного в LogContainerCount. Если этот флаг и TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE установлены, журналу предписывается сжаться до минимально допустимого размера, а LogContainerCount игнорируется. |
|
Если этот флаг и TXFS_RM_FLAG_SHRINK_LOG заданы, журналу предписывается сжаться до минимально допустимого размера, а LogContainerCount игнорируется. Если этот флаг установлен, необходимо задать TXFS_RM_FLAG_SHRINK_LOG . |
|
Если этот флаг установлен, журналу предписывается сохранить изменения на диске. Если этот флаг не установлен, все внесенные изменения являются временными (т. е. до завершения работы и перезапуска RM). |
|
Этот флаг действителен только для модулей RM по умолчанию, но не для вторичных RM. Если этот флаг установлен, RM получает указание выполнить сброс при следующем запуске. Журнал и связанные с ним метаданные удаляются. |
|
Этот флаг действителен только для модулей RM по умолчанию, но не для вторичных RM. Если этот флаг установлен, предыдущий вызов FSCTL_TXFS_MODIFY_RM отменяется с установленным флагом TXFS_RM_FLAG_RESET_RM_AT_NEXT_START . |
|
Указывает, что RM предпочитает согласованность транзакций , а не доступность системы. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_PREFER_AVAILABILITY и не поддерживается RM по умолчанию на системном томе. |
|
Указывает, что RM предпочитает доступность системы , а не согласованность транзакций. Этот флаг является взаимоисключающим с TXFS_RM_FLAG_PREFER_CONSISTENCY и принудительно применяется по умолчанию RM на системном томе. |
LogContainerCountMax
Максимальный размер журнала в контейнерах.
LogContainerCountMin
Минимальный размер журнала в контейнерах.
LogContainerCount
Фактический размер журнала в контейнерах.
LogGrowthIncrement
Количество контейнеров или процент пространства, которые должны быть добавлены в журнал.
LogAutoShrinkPercentage
Процент свободного пространства журнала. Этот элемент используется при использовании флага TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE и предписывает журналу автоматически сжаться, поэтому только LogAutoShrinkPercentage журнала будет бесплатным в любой момент времени.
Reserved
Зарезервировано.
LoggingMode
Текущий режим ведения журнала.
| Значение | Значение |
|---|---|
|
Используется простое ведение журнала. |
|
Используется полное ведение журнала |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Верхняя часть | winioctl.h (включая Windows.h) |