TXFS_QUERY_RM_INFORMATION structure (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 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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|---|---|
|
La journalisation simple est utilisée. |
|
La journalisation complète est utilisée |
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 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) |