estrutura TXFS_MODIFY_RM (winioctl.h)
[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do aplicativo. Muitos cenários para os quais o TxF foi desenvolvido podem ser obtidos por meio de técnicas mais simples e prontamente disponíveis. Além disso, o TxF pode não estar disponível em versões futuras do Microsoft Windows. Para obter mais informações e alternativas ao TxF, confira Alternativas ao uso do NTFS transacional.]
Contém as informações necessárias ao modificar parâmetros de log e o modo de registro em log para um gerenciador de recursos secundário.
Sintaxe
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;
Membros
Flags
Os parâmetros de log a serem definidos.
Esse membro pode ser um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
Se esse sinalizador estiver definido, o membro LoggingMode dessa estrutura será usado. Se o sinalizador não estiver definido, o membro LoggingMode será ignorado. |
|
Se esse sinalizador estiver definido, o RM será instruído a renomear a si mesmo (criando um novo GUID). |
|
Se esse sinalizador estiver definido, o membro LogContainerCountMax será usado. Se o sinalizador não estiver definido, o membro LogContainerCountMax será ignorado. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Se esse sinalizador estiver definido, o membro LogContainerCountMin será usado. Se o sinalizador não estiver definido, o membro LogContainerCountMin será ignorado. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Se esse sinalizador estiver definido, o membro LogGrowthIncrement será usado. Se o sinalizador não estiver definido, o membro LogGrowthIncrement será ignorado. Esse sinalizador indica que o log deve aumentar pelo número de contêineres especificados no membro LogGrowthIncrement . Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Se esse sinalizador estiver definido, o membro LogGrowthIncrement será usado. Se o sinalizador não estiver definido, o membro LogGrowthIncrement será ignorado. Esse sinalizador indica que o log deve aumentar pela porcentagem do tamanho do log especificado no membro LogGrowthIncrement . Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Se esse sinalizador estiver definido, o membro LogAutoShrinkPercentage será usado. Se o sinalizador não estiver definido, o LogAutoShrinkPercentage será ignorado. |
|
Se esse sinalizador for definido, o RM será instruído a permitir que seu log cresça sem limites. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Se esse sinalizador estiver definido, o RM será instruído a permitir que seu log reduza o log para apenas dois contêineres. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Se esse sinalizador estiver definido, o log será instruído a aumentar imediatamente seu tamanho para o tamanho especificado em LogContainerCount. Se o sinalizador não estiver definido, LogContainerCount será ignorado. |
|
Se esse sinalizador for definido, o log será instruído a diminuir imediatamente seu tamanho para o tamanho especificado em LogContainerCount. Se esse sinalizador e TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE estiverem definidos, o log será instruído a reduzir para o tamanho mínimo permitido e LogContainerCount será ignorado. |
|
Se esse sinalizador e TXFS_RM_FLAG_SHRINK_LOG estiverem definidos, o log será instruído a reduzir para o tamanho mínimo permitido e LogContainerCount será ignorado. Se esse sinalizador estiver definido, o TXFS_RM_FLAG_SHRINK_LOG deverá ser definido. |
|
Se esse sinalizador estiver definido, o log será instruído a preservar as alterações no disco. Se esse sinalizador não estiver definido, todas as alterações feitas serão temporárias (ou seja, até que a RM seja desligada e reiniciada). |
|
Esse sinalizador só é válido para RMs padrão, não RMs secundárias. Se esse sinalizador estiver definido, o RM será instruído a redefinir-se na próxima vez que for iniciado. O log e os metadados associados são excluídos. |
|
Esse sinalizador só é válido para RMs padrão, não RMs secundárias. Se esse sinalizador for definido, uma chamada anterior para FSCTL_TXFS_MODIFY_RM será cancelada com o sinalizador TXFS_RM_FLAG_RESET_RM_AT_NEXT_START definido. |
|
Indica que a RM deve preferir a consistência da transação em vez da disponibilidade do sistema. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_PREFER_AVAILABILITY e não é compatível com a RM padrão no volume do sistema. |
|
Indica que a RM deve preferir a disponibilidade do sistema em vez da consistência da transação. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_PREFER_CONSISTENCY e é forçado pela RM padrão no volume do sistema. |
LogContainerCountMax
O tamanho máximo do log, em contêineres.
LogContainerCountMin
O tamanho mínimo do log, em contêineres.
LogContainerCount
O tamanho real do log, em contêineres.
LogGrowthIncrement
O número de contêineres ou percentual de espaço que deve ser adicionado ao log.
LogAutoShrinkPercentage
A porcentagem de espaço de log a ser mantido livre. Esse membro é usado quando o sinalizador TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE é usado e instrui o log a se reduzir automaticamente, portanto, não mais do que LogAutoShrinkPercentage do log é gratuito a qualquer momento.
Reserved
Reservado.
LoggingMode
O modo de registro em log atual.
| Valor | Significado |
|---|---|
|
O registro em log simples é usado. |
|
O log completo é usado |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | winioctl.h (inclua Windows.h) |