TXFS_MODIFY_RM 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 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 |
|---|---|
|
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é. |
|
Si cet indicateur est défini, le rm est invité à se renommer (création d’un GUID). |
|
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. |
|
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. |
|
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. |
|
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. |
|
Si cet indicateur est défini, le membre LogAutoShrinkPercentage est utilisé. Si l’indicateur n’est pas défini, logAutoShrinkPercentage est ignoré. |
|
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. |
|
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. |
|
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é. |
|
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é. |
|
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. |
|
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). |
|
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. |
|
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. |
|
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. |
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 |
|---|---|
|
La journalisation simple est utilisée. |
|
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) |