structure TXFS_QUERY_RM_INFORMATION (winioctl.h)

[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios développés par TxF peuvent être réalisés par le biais de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les futures versions de Microsoft Windows. Pour plus d’informations et des alternatives à TxF, consultez Alternatives à l’utilisation de NTFS transactionnel.]

Contient des informations sur le gestionnaire de ressources (RM).

Syntaxe

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;

Members

BytesRequired

Si FSCTL_TXFS_QUERY_RM_INFORMATION retourne ERROR_BUFFER_TOO_SMALL, ce membre spécifie le nombre minimal d’octets nécessaires pour retourner les informations demandées, y compris le caractère de fin NULL .

TailLsn

Numéro de séquence de journal le plus ancien (LSN) actuellement utilisé par le RM.

CurrentLsn

LSN le plus récemment utilisé par le RM dans son journal.

ArchiveTailLsn

LSN de la fin d’archive du journal.

LogContainerSize

Taille réelle d’un conteneur de journaux, en octets.

HighestVirtualClock

Horodatage le plus élevé associé à un enregistrement de journal.

LogContainerCount

Nombre de conteneurs de journaux.

LogContainerCountMax

Nombre maximal de conteneurs de journaux.

LogContainerCountMin

Nombre minimal de conteneurs autorisés dans le journal.

LogGrowthIncrement

La quantité du journal augmente, soit en nombre de conteneurs, soit en pourcentage de la taille du journal ; le type de croissance utilisé est spécifié par les indicateurs définis dans le membre Flags .

LogAutoShrinkPercentage

Si la stratégie de réduction automatique est active, ce membre spécifie la quantité maximale autorisée d’espace libre dans le journal. Si ce membre est égal à zéro, la stratégie de réduction automatique n’est pas active.

Flags

Ce membre peut être une ou plusieurs des valeurs suivantes.

LoggingMode

Mode de journalisation actuel.

Reserved

Réservé.

RmState

État du RM. Les valeurs valides sont les suivantes.

LogCapacity

Capacité totale du journal, en octets.

LogFree

Nombre d’octets libres dans le journal.

TopsSize

Taille du fichier $Tops, en octets.

TopsUsed

Quantité du fichier $Tops en cours d’utilisation, en octets.

TransactionCount

Nombre de transactions actives, au moment de l’émission de la requête.

OnePCCount

Nombre d’opérations de validation monophases qui se sont produites sur ce RM.

TwoPCCount

Nombre d’opérations de validation en deux phases qui se sont produites sur ce RM.

NumberLogFileFull

Nombre de fois que le journal de ce RM est plein.

OldestTransactionAge

Longueur de la transaction active la plus ancienne, en millisecondes.

RMName

GUID qui indique le nom de ce RM.

TmLogPathOffset

Décalage entre le début de cette structure et une chaîne Unicode terminée par NULL qui contient le chemin d’accès au journal du TM.

Spécifications

Voir aussi

FSCTL_TXFS_QUERY_RM_INFORMATION

TxF Structures