TXFS_QUERY_RM_INFORMATION-Struktur (winioctl.h)
[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 Informationen zum Resource Manager (RM).
Syntax
typedef struct _TXFS_QUERY_RM_INFORMATION {
DWORD BytesRequired;
DWORDLONG TailLsn;
DWORDLONG CurrentLsn;
DWORDLONG ArchiveTailLsn;
DWORDLONG LogContainerSize;
LARGE_INTEGER HighestVirtualClock;
DWORD LogContainerCount;
DWORD LogContainerCountMax;
DWORD LogContainerCountMin;
DWORD LogGrowthIncrement;
DWORD LogAutoShrinkPercentage;
DWORD Flags;
WORD LoggingMode;
WORD Reserved;
DWORD RmState;
DWORDLONG LogCapacity;
DWORDLONG LogFree;
DWORDLONG TopsSize;
DWORDLONG TopsUsed;
DWORDLONG TransactionCount;
DWORDLONG OnePCCount;
DWORDLONG TwoPCCount;
DWORDLONG NumberLogFileFull;
DWORDLONG OldestTransactionAge;
GUID RMName;
DWORD TmLogPathOffset;
} TXFS_QUERY_RM_INFORMATION, *PTXFS_QUERY_RM_INFORMATION;
Member
BytesRequired
Wenn FSCTL_TXFS_QUERY_RM_INFORMATIONERROR_BUFFER_TOO_SMALL zurückgibt, gibt dieses Element die Mindestanzahl von Bytes an, die zum Zurückgeben der angeforderten Informationen erforderlich sind, einschließlich des NULL-Endzeichens.
TailLsn
Die älteste Protokollsequenznummer (LSN), die derzeit vom RM verwendet wird.
CurrentLsn
Der LSN, der zuletzt vom RM in seinem Protokoll verwendet wurde.
ArchiveTailLsn
Der LSN des Archivendes des Protokolls.
LogContainerSize
Die tatsächliche Größe eines Protokollcontainers in Bytes.
HighestVirtualClock
Der höchste Zeitstempel, der einem Protokolldatensatz zugeordnet ist.
LogContainerCount
Die Anzahl der Protokollcontainer.
LogContainerCountMax
Die maximale Anzahl von Protokollcontainern.
LogContainerCountMin
Die Mindestanzahl von Containern, die im Protokoll zulässig sind.
LogGrowthIncrement
Der Betrag, um den das Protokoll wächst, wobei es sich entweder um eine Anzahl von Containern oder um einen Prozentsatz der Protokollgröße handelt; der verwendete Wachstumstyp wird durch die Flags angegeben, die im Flags-Element festgelegt sind.
LogAutoShrinkPercentage
Wenn die Richtlinie zum automatischen Verkleinern aktiv ist, gibt dieses Element die maximal zulässige Menge an freiem Speicherplatz im Protokoll an. Wenn dieser Member 0 ist, ist die Richtlinie zum automatischen Verkleinern nicht aktiv.
Flags
Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.
| Wert | Bedeutung |
|---|---|
|
Wenn das Flag festgelegt ist, darf das Protokoll des RM so weit wie möglich verkleinern. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX aus. |
|
Gibt den Werttyp in LogGrowthIncrement an. Wenn dieses Flag festgelegt ist, ist LogGrowthIncrement eine Reihe von Containern. Dieses Flag schließt sich mit TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT gegenseitig aus. |
|
Gibt den Werttyp in LogGrowthIncrement an. Wenn dieses Flag festgelegt ist, ist LogGrowthIncrement ein Prozentsatz. Dieses Flag schließt sich mit TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS gegenseitig aus. |
|
Gibt an, dass das Protokoll des RM ohne Grenzen wachsen kann. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN aus. |
|
Gibt den aktuellen Zustand des RM-Zurücksetzungsflags an. Wenn dies festgelegt ist, setzt sich die RM beim nächsten Start selbst zurück. Dieses Flag ist nur für Standard-RMs gültig, nicht für sekundäre RMs. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START aus. |
|
Gibt den aktuellen Zustand des RM-Zurücksetzungsflags an. Wenn dies festgelegt ist, setzt sich der RM beim nächsten Start nicht zurück. Dieses Flag ist nur für Standard-RMs gültig, nicht für sekundäre RMs. Dieses Flag schließt sich gegenseitig mit TXFS_RM_FLAG_RESET_RM_AT_NEXT_START aus. |
|
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. |
|
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. |
LoggingMode
Der aktuelle Protokollierungsmodus.
| Wert | Bedeutung |
|---|---|
|
Es wird eine einfache Protokollierung verwendet. |
|
Vollständige Protokollierung wird verwendet |
Reserved
Reserviert.
RmState
Der Status des RM. Gültige Werte sind:
LogCapacity
Die Gesamtkapazität des Protokolls in Bytes.
LogFree
Die Anzahl der freien Bytes im Protokoll.
TopsSize
Die Größe der $Tops-Datei in Bytes.
TopsUsed
Die Menge der verwendeten $Tops Datei in Bytes.
TransactionCount
Die Anzahl der aktiven Transaktionen zum Zeitpunkt der Abfrageausgabe.
OnePCCount
Die Anzahl der einphasigen Commitvorgänge, die für diesen RM aufgetreten sind.
TwoPCCount
Die Anzahl der zweiphasigen Commitvorgänge, die für diesen RM aufgetreten sind.
NumberLogFileFull
Die Häufigkeit, mit der das Protokoll dieses RM voll geworden ist.
OldestTransactionAge
Die Länge der ältesten aktiven Transaktion in Millisekunden.
RMName
Die GUID , die den Namen dieses RM angibt.
TmLogPathOffset
Der Offset vom Anfang dieser Struktur zu einer MIT NULL beendeten Unicode-Zeichenfolge, die den Pfad zum TM-Protokoll enthält.
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 (windows.h einschließen) |