TXFS_MODIFY_RM 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 les informations requises lors de la modification des paramètres de journalisation et du mode de journalisation d’un gestionnaire de ressources secondaire.

Syntaxe

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;

Membres

Flags

Paramètres de journal à définir.

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

Valeur Signification
TXFS_RM_FLAG_LOGGING_MODE
0x00000001
 Si cet indicateur est défini, le membre LoggingMode de cette structure est utilisé. Si l’indicateur n’est pas défini, le membre LoggingMode est ignoré.
TXFS_RM_FLAG_RENAME_RM
0x00000002
 Si cet indicateur est défini, le rm est invité à se renommer (création d’un GUID).
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MAX
0x00000004
 Si cet indicateur est défini, le membre LogContainerCountMax est utilisé. Si l’indicateur n’est pas défini, le membre LogContainerCountMax est ignoré. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN.
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
 Si cet indicateur est défini, le membre LogContainerCountMin est utilisé. Si l’indicateur n’est pas défini, le membre LogContainerCountMin est ignoré. Cet indicateur s’exclut mutuellement avec TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
 Si cet indicateur est défini, le membre LogGrowthIncrement est utilisé. Si l’indicateur n’est pas défini, le membre LogGrowthIncrement est ignoré. Cet indicateur indique que le journal doit croître du nombre de conteneurs spécifiés dans le membre LogGrowthIncrement . Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT.
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
 Si cet indicateur est défini, le membre LogGrowthIncrement est utilisé. Si l’indicateur n’est pas défini, le membre LogGrowthIncrement est ignoré. Cet indicateur indique que le journal doit croître du pourcentage de la taille de journal spécifiée dans le membre LogGrowthIncrement . Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS.
TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE
0x00000040
 Si cet indicateur est défini, le membre LogAutoShrinkPercentage est utilisé. Si l’indicateur n’est pas défini, logAutoShrinkPercentage est ignoré.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
 Si cet indicateur est défini, le rm est invité à autoriser la croissance de son journal sans limites. Cet indicateur s’exclut mutuellement de TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN.
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN
0x00000100
 Si cet indicateur est défini, le rm est invité à autoriser son journal à réduire le journal à deux conteneurs uniquement. Cet indicateur s’exclut mutuellement avec TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX.
TXFS_RM_FLAG_GROW_LOG
0x00000400
 Si cet indicateur est défini, le journal est invité à augmenter immédiatement sa taille à la taille spécifiée dans LogContainerCount. Si l’indicateur n’est pas défini, logContainerCount est ignoré.
TXFS_RM_FLAG_SHRINK_LOG
0x00000800
 Si cet indicateur est défini, le journal est invité à réduire immédiatement sa taille à la taille spécifiée dans LogContainerCount. Si cet indicateur et ce TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE sont définis, le journal est invité à réduire à sa taille minimale autorisée, et LogContainerCount est ignoré.
TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE
0x00001000
 Si cet indicateur et ce TXFS_RM_FLAG_SHRINK_LOG sont définis, le journal est invité à réduire à sa taille minimale autorisée, et LogContainerCount est ignoré. Si cet indicateur est défini, le TXFS_RM_FLAG_SHRINK_LOG doit être défini.
TXFS_RM_FLAG_PRESERVE_CHANGES
0x00002000
 Si cet indicateur est défini, le journal est invité à conserver les modifications sur le disque. Si cet indicateur n’est pas défini, toutes les modifications apportées sont temporaires (c’est-à-dire, jusqu’à ce que la rm soit arrêtée et redémarrée).
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
 Cet indicateur n’est valide que pour les machines de requête par défaut, et non pour les machines réservées secondaires. Si cet indicateur est défini, le rm est invité à se réinitialiser la prochaine fois qu’il sera démarré. Le journal et les métadonnées associées sont supprimés.
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 Cet indicateur n’est valide que pour les machines de requête par défaut, et non pour les machines réservées secondaires. Si cet indicateur est défini, un appel précédent à FSCTL_TXFS_MODIFY_RM est annulé avec l’indicateur TXFS_RM_FLAG_RESET_RM_AT_NEXT_START défini.
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.

LogContainerCountMax

Taille maximale du journal, dans les conteneurs.

LogContainerCountMin

Taille minimale du journal, dans les conteneurs.

LogContainerCount

Taille réelle du journal, dans les conteneurs.

LogGrowthIncrement

Nombre de conteneurs ou pourcentage d’espace à ajouter au journal.

LogAutoShrinkPercentage

Pourcentage d’espace journal à conserver libre. Ce membre est utilisé lorsque l’indicateur de TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE est utilisé et indique au journal de se réduire automatiquement, de sorte que LogAutoShrinkPercentage du journal est libre à un moment donné.

Reserved

Réservé.

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

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_MODIFY_RM