TXFS_MODIFY_RM-Struktur (winioctl.h)

Artikel
03/04/2024

[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarios, für die TxF entwickelt wurde, können mit einfacheren und leichter verfügbaren Techniken erreicht werden. Darüber hinaus ist TxF in zukünftigen Versionen von Microsoft Windows möglicherweise nicht verfügbar. Weitere Informationen und Alternativen zu TxF finden Sie unter Alternativen zur Verwendung von transaktionalem NTFS.]

Enthält die Informationen, die beim Ändern der Protokollparameter und des Protokollierungsmodus für einen sekundären Resource Manager erforderlich sind.

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;

Member

Flags

Die festzulegenden Protokollparameter.

Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
TXFS_RM_FLAG_LOGGING_MODE 0x00000001	Wenn dieses Flag festgelegt ist, wird das LoggingMode-Element dieser Struktur verwendet. Wenn das Flag nicht festgelegt ist, wird das LoggingMode-Element ignoriert.
TXFS_RM_FLAG_RENAME_RM 0x00000002	Wenn dieses Flag festgelegt ist, wird der RM angewiesen, sich selbst umzubenennen (erstellen einer neuen GUID).
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MAX 0x00000004	Wenn dieses Flag festgelegt ist, wird das LogContainerCountMax-Element verwendet. Wenn das Flag nicht festgelegt ist, wird das LogContainerCountMax-Element ignoriert. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN aus.
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN 0x00000008	Wenn dieses Flag festgelegt ist, wird das LogContainerCountMin-Element verwendet. Wenn das Flag nicht festgelegt ist, wird das LogContainerCountMin-Element ignoriert. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX aus.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS 0x00000010	Wenn dieses Flag festgelegt ist, wird das LogGrowthIncrement-Element verwendet. Wenn das Flag nicht festgelegt ist, wird das LogGrowthIncrement-Element ignoriert. Dieses Flag gibt an, dass das Protokoll um die Anzahl von Containern wachsen soll, die im LogGrowthIncrement-Element angegeben ist. Dieses Flag schließt sich mit TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT gegenseitig aus.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT 0x00000020	Wenn dieses Flag festgelegt ist, wird das LogGrowthIncrement-Element verwendet. Wenn das Flag nicht festgelegt ist, wird das LogGrowthIncrement-Element ignoriert. Dieses Flag gibt an, dass das Protokoll um den Prozentsatz der Protokollgröße wachsen soll, die im LogGrowthIncrement-Element angegeben ist. Dieses Flag schließt sich mit TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS gegenseitig aus.
TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE 0x00000040	Wenn dieses Flag festgelegt ist, wird das LogAutoShrinkPercentage-Element verwendet. Wenn das Flag nicht festgelegt ist, wird logAutoShrinkPercentage ignoriert.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX 0x00000080	Wenn dieses Flag festgelegt ist, wird der RM angewiesen, das Protokoll ohne Grenzen zu vergrößern. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN aus.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN 0x00000100	Wenn dieses Flag festgelegt ist, wird der RM angewiesen, seinem Protokoll zu erlauben, das Protokoll auf nur zwei Container zu verkleinern. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX aus.
TXFS_RM_FLAG_GROW_LOG 0x00000400	Wenn dieses Flag festgelegt ist, wird das Protokoll angewiesen, seine Größe sofort auf die in LogContainerCount angegebene Größe zu erhöhen. Wenn das Flag nicht festgelegt ist, wird logContainerCount ignoriert.
TXFS_RM_FLAG_SHRINK_LOG 0x00000800	Wenn dieses Flag festgelegt ist, wird das Protokoll angewiesen, seine Größe sofort auf die in LogContainerCount angegebene Größe zu verringern. Wenn dieses Flag und TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE festgelegt sind, wird das Protokoll angewiesen, auf die zulässige Mindestgröße zu verkleinern, und LogContainerCount wird ignoriert.
TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE 0x00001000	Wenn dieses Flag und TXFS_RM_FLAG_SHRINK_LOG festgelegt sind, wird das Protokoll angewiesen, auf die zulässige Mindestgröße zu verkleinern, und LogContainerCount wird ignoriert. Wenn dieses Flag festgelegt ist, muss die TXFS_RM_FLAG_SHRINK_LOG festgelegt werden.
TXFS_RM_FLAG_PRESERVE_CHANGES 0x00002000	Wenn dieses Flag festgelegt ist, wird das Protokoll angewiesen, die Änderungen auf dem Datenträger beizubehalten. Wenn dieses Flag nicht festgelegt ist, sind alle vorgenommenen Änderungen temporär (d. h. bis das RM heruntergefahren und neu gestartet wird).
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START 0x00004000	Dieses Flag ist nur für Standard-RMs gültig, nicht für sekundäre RMs. Wenn dieses Flag festgelegt ist, wird der RM angewiesen, sich beim nächsten Start zurückzusetzen. Das Protokoll und die zugehörigen Metadaten werden gelöscht.
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START 0x00008000	Dieses Flag ist nur für Standard-RMs gültig, nicht für sekundäre RMs. Wenn dieses Flag festgelegt ist, wird ein vorheriger Aufruf von FSCTL_TXFS_MODIFY_RM mit dem TXFS_RM_FLAG_RESET_RM_AT_NEXT_START-Flag abgesagt.
TXFS_RM_FLAG_PREFER_CONSISTENCY 0x00010000	Gibt an, dass die RM Transaktionskonsistenz der Systemverfügbarkeit vorzieht. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_PREFER_AVAILABILITY aus und wird von der Standard-RM auf dem Systemvolume nicht unterstützt.
TXFS_RM_FLAG_PREFER_AVAILABILITY 0x00020000	Gibt an, dass die RM die Systemverfügbarkeit der Transaktionskonsistenz vorzieht. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_PREFER_CONSISTENCY aus und wird durch die Standard-RM auf dem Systemvolume erzwungen.

LogContainerCountMax

Die maximale Größe des Protokolls in Containern.

LogContainerCountMin

Die Mindestgröße des Protokolls in Containern.

LogContainerCount

Die tatsächliche Größe des Protokolls in Containern.

LogGrowthIncrement

Die Anzahl der Container oder der Prozentsatz des Speicherplatzes, der dem Protokoll hinzugefügt werden soll.

LogAutoShrinkPercentage

Der Prozentsatz des Protokollspeicherplatzes, der frei bleiben soll. Dieses Element wird verwendet, wenn das TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE-Flag verwendet wird, und weist das Protokoll an, sich automatisch zu verkleinern, sodass nicht mehr als LogAutoShrinkPercentage des Protokolls zu einem bestimmten Zeitpunkt frei ist.

Reserved

Reserviert.

LoggingMode

Der aktuelle Protokollierungsmodus.

Wert	Bedeutung
TXFS_LOGGING_MODE_SIMPLE 1	Es wird eine einfache Protokollierung verwendet.
TXFS_LOGGING_MODE_FULL 2	Vollständige Protokollierung wird verwendet

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_TXFS_MODIFY_RM

Freigeben über