通过

TXFS_MODIFY_RM结构（winioctl.h）

[Microsoft强烈建议开发人员利用替代方法来实现应用程序的需求。 TxF 开发的许多方案可以通过更简单、更易用的技术来实现。 此外，TxF 在 Microsoft Windows 的未来版本中可能不可用。 有关详细信息，以及 TxF 的替代项，请参阅 使用事务 NTFS 的替代项。]

包含修改辅助资源管理器的日志参数和日志记录模式时所需的信息。

Syntax

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;

Members

Flags

要设置的日志参数。

此成员可以是以下一个或多个值。

价值 Meaning
TXFS_RM_FLAG_LOGGING_MODE
0x00000001
 如果设置了此标志，则使用此结构的 LoggingMode 成员。 如果未设置标志，则忽略 LoggingMode 成员。
TXFS_RM_FLAG_RENAME_RM
0x00000002
 如果设置了此标志，则指示 RM 重命名自身（创建新的 GUID）。
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MAX
0x00000004
 如果设置了此标志，则使用 LogContainerCountMax 成员。 如果未设置标志，则忽略 LogContainerCountMax 成员。 此标志与 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN互斥。
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
 如果设置了此标志，则使用 LogContainerCountMin 成员。 如果未设置标志， 则忽略 LogContainerCountMin 成员。 此标志与 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX互斥。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
 如果设置了此标志，则正在使用 LogGrowthIncrement 成员。 如果未设置标志， 则忽略 LogGrowthIncrement 成员。 此标志指示日志应按 LogGrowthIncrement 成员中指定的容器数增长。 此标志与 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT互斥。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
 如果设置了此标志，则正在使用 LogGrowthIncrement 成员。 如果未设置标志， 则忽略 LogGrowthIncrement 成员。 此标志指示日志应按 LogGrowthIncrement 成员中指定的日志大小的百分比增长。 此标志与 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS互斥。
TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE
0x00000040
 如果设置了此标志，则正在使用 LogAutoShrinkPercentage 成员。 如果未设置标志，则忽略 LogAutoShrinkPercentage 。
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
 如果设置了此标志，则指示 RM 允许其日志在没有边界的情况下增长。 此标志与 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN互斥。
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN
0x00000100
 如果设置了此标志，则指示 RM 允许其日志将日志收缩为两个容器。 此标志与 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX互斥。
TXFS_RM_FLAG_GROW_LOG
0x00000400
 如果设置了此标志，则指示日志立即将其大小增加到 LogContainerCount 中指定的大小。 如果未设置标志， 则忽略 LogContainerCount 。
TXFS_RM_FLAG_SHRINK_LOG
0x00000800
 如果设置了此标志，则指示日志立即将其大小减小到 LogContainerCount 中指定的大小。 如果设置了此标志和 TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE ，则会指示日志收缩到其最小允许大小，并忽略 LogContainerCount 。
TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE
0x00001000
 如果设置了此标志和 TXFS_RM_FLAG_SHRINK_LOG ，则会指示日志收缩到其最小允许大小，并忽略 LogContainerCount 。 如果设置了此标志，则必须设置 TXFS_RM_FLAG_SHRINK_LOG 。
TXFS_RM_FLAG_PRESERVE_CHANGES
0x00002000
 如果设置了此标志，则会指示日志保留磁盘上的更改。 如果未设置此标志，则所做的任何更改都是临时的（即，在 RM 关闭并重启之前）。
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
 此标志仅适用于默认 RM，而不适用于辅助 RM。 如果设置了此标志，则指示 RM 在下一次启动时重置自身。 日志和关联的元数据将被删除。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 此标志仅适用于默认 RM，而不适用于辅助 RM。 如果设置了此标志，则取消对 FSCTL_TXFS_MODIFY_RM 的上一次调用，并设置了 TXFS_RM_FLAG_RESET_RM_AT_NEXT_START 标志。
TXFS_RM_FLAG_PREFER_CONSISTENCY
0x00010000
 指示 RM 优先于事务 一致性 而不是系统 可用性。 此标志与 TXFS_RM_FLAG_PREFER_AVAILABILITY 互斥，系统卷上的默认 RM 不支持此标志。
TXFS_RM_FLAG_PREFER_AVAILABILITY
0x00020000
 指示 RM 优先于系统 可用性 而不是事务 一致性。 此标志与 TXFS_RM_FLAG_PREFER_CONSISTENCY 互斥，由系统卷上的默认 RM 强制使用。

LogContainerCountMax

容器中日志的最大大小。

LogContainerCountMin

容器中日志的最小大小。

LogContainerCount

容器中日志的实际大小。

LogGrowthIncrement

应添加到日志中的容器数或空间百分比。

LogAutoShrinkPercentage

要释放的日志空间百分比。 使用 TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE 标志时使用此成员，并指示日志自动收缩自身，因此在任何给定时间，日志的 LogAutoShrinkPercentage 都免费。

Reserved

预留。

LoggingMode

当前日志记录模式。

价值 Meaning
TXFS_LOGGING_MODE_SIMPLE
1
 使用简单日志记录。
TXFS_LOGGING_MODE_FULL
2
 使用完整日志记录

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
Header winioctl.h （包括 Windows.h）

另请参阅

FSCTL_TXFS_MODIFY_RM

  • Last updated on