TXFS_QUERY_RM_INFORMATION structure (winioctl.h)

  • Article

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

Contient des informations sur le gestionnaire de ressources.

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;

Membres

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 séquentiel du 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

Montant de croissance du journal, qui correspond à un nombre de conteneurs ou à un pourcentage de la taille du journal ; le type de croissance utilisé est spécifié par les indicateurs définis dans le membre Indicateurs .

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.

Valeur Signification
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
 Si l’indicateur est défini, le journal du rm est autorisé à se réduire autant que possible. Cet indicateur s’exclut mutuellement avec TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
 Indique le type de valeur dans LogGrowthIncrement. Si cet indicateur est défini, LogGrowthIncrement est un certain nombre de conteneurs. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
 Indique le type de valeur dans LogGrowthIncrement. Si cet indicateur est défini, LogGrowthIncrement est un pourcentage. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
 Indique que le journal du rm peut croître sans limites. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN.
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
 Indique l’état actuel de l’indicateur de réinitialisation RM. Si ce paramètre est défini, le rm se réinitialise la prochaine fois qu’il sera démarré. Cet indicateur n’est valide que pour les machines de requête par défaut, et non pour les machines réservées secondaires. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 Indique l’état actuel de l’indicateur de réinitialisation RM. Si cette option est définie, la rm n’est pas réinitialisée la prochaine fois qu’elle sera démarrée. Cet indicateur n’est valide que pour les machines de requête par défaut, et non pour les machines réservées secondaires. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_RESET_RM_AT_NEXT_START.
TXFS_RM_FLAG_PREFER_CONSISTENCY
0x00010000
 Indique que le rmr doit préférer la cohérence des transactions à la disponibilité du système. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_PREFER_AVAILABILITY et n’est pas pris en charge par le rm par défaut sur le volume système.
TXFS_RM_FLAG_PREFER_AVAILABILITY
0x00020000
 Indique que le rmr doit préférer la disponibilité du système à la cohérence des transactions. Cet indicateur s’exclut mutuellement avec TXFS_RM_FLAG_PREFER_CONSISTENCY et est forcé par la rm par défaut sur le volume système.

LoggingMode

Mode de journalisation actuel.

Valeur Signification
TXFS_LOGGING_MODE_SIMPLE
1
 La journalisation simple est utilisée.
TXFS_LOGGING_MODE_FULL
2
 La journalisation complète est utilisée

Reserved

Réservé.

RmState

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

Valeur Signification
TXFS_RM_STATE_NOT_STARTED
0
 Le rm n’est pas encore démarré.
TXFS_RM_STATE_STARTING
1
 Le rm est en cours de démarrage.
TXFS_RM_STATE_ACTIVE
2
 Le rm est actif et prêt à accepter des transactions.
TXFS_RM_STATE_SHUTTING_DOWN
3
 Le rm est en cours d’arrêt.

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 en une seule phase 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 saturé.

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

FSCTL_TXFS_QUERY_RM_INFORMATION

Structures TxF