共用方式為

TXFS_MODIFY_RM結構 (winioctl.h)

  • 發行項

[Microsoft 強烈建議開發人員利用替代方法來達成應用程式的需求。 許多針對 TxF 開發的案例，都可以透過更簡單且更容易取得的技術來達成。 此外，未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊，以及 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

要設定的記錄參數。

這個成員可以是下列一或多個值。

值 意義
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，不適用於次要 RU。 如果設定此旗標，則會指示 RM 在下一次啟動時自行重設。 系統會刪除記錄檔和相關聯的元數據。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 此旗標僅適用於預設的 RM，不適用於次要 RU。 如果設定此旗標，則會取消先前 對 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

目前的記錄模式。

值 意義
TXFS_LOGGING_MODE_SIMPLE
1
 使用簡單的記錄。
TXFS_LOGGING_MODE_FULL
2
 使用完整記錄

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 winioctl.h (包含 Windows.h)

另請參閱

FSCTL_TXFS_MODIFY_RM