Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 les informations requises lors de la modification des paramètres de journal et du mode de journalisation pour 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;
Members
Flags
Paramètres de journal à définir.
Ce membre peut être une ou plusieurs des valeurs suivantes.
| Valeur | Meaning |
|---|---|
|
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 lui-même (en créant 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’exclue mutuellement avec 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’exclue 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 en fonction du nombre de conteneurs spécifiés dans le membre LogGrowthIncrement . Cet indicateur s’exclue mutuellement avec 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 en pourcentage de la taille du journal spécifiée dans le membre LogGrowthIncrement . Cet indicateur s’exclue mutuellement avec 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 son journal à croître sans limites. Cet indicateur s’exclue mutuellement avec 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 seulement. Cet indicateur s’exclue 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 cette 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 cette 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, la TXFS_RM_FLAG_SHRINK_LOG doit être définie. |
|
Si cet indicateur est défini, le journal est invité à conserver les modifications sur le disque. Si cet indicateur n’est pas défini, les modifications apportées sont temporaires (autrement dit, jusqu’à ce que le RM soit arrêté et redémarré). |
|
Cet indicateur est valide uniquement pour les machines virtuelles par défaut, et non pour les machines virtuelles secondaires. Si cet indicateur est défini, le RM est invité à se réinitialiser la prochaine fois qu’il est démarré. Le journal et les métadonnées associées sont supprimés. |
|
Cet indicateur est valide uniquement pour les machines virtuelles par défaut, et non pour les machines virtuelles secondaires. Si cet indicateur est défini, un appel précédent à FSCTL_TXFS_MODIFY_RM est annulé avec l’indicateur de TXFS_RM_FLAG_RESET_RM_AT_NEXT_START défini. |
|
Indique que rm est de préférer la cohérence des transactions par rapport à la disponibilité du système. Cet indicateur s’exclue mutuellement avec 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 rm est de préférer la disponibilité du système par rapport à la cohérence des transactions. Cet indicateur s’exclue mutuellement avec TXFS_RM_FLAG_PREFER_CONSISTENCY et est forcé par le 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 qui doivent être ajoutés au journal.
LogAutoShrinkPercentage
Pourcentage d’espace journal à libérer. 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, donc pas plus que LogAutoShrinkPercentage du journal est libre à tout moment.
Reserved
Réservé.
LoggingMode
Mode de journalisation actuel.
| Valeur | Meaning |
|---|---|
|
La journalisation simple est utilisée. |
|
La journalisation complète est utilisée |
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Header | winioctl.h (include Windows.h) |