Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para alcançar as 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, consulte Alternativas para usar o NTFS transacional.]
Contém informações sobre o gerenciador de recursos (RM).
Sintaxe
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;
Members
BytesRequired
Se FSCTL_TXFS_QUERY_RM_INFORMATION retornar ERROR_BUFFER_TOO_SMALL, esse membro especificará o número mínimo de bytes necessários para retornar as informações solicitadas, incluindo o caractere de terminação NULL .
TailLsn
O LSN (número de sequência de log) mais antigo usado atualmente pelo RM.
CurrentLsn
O LSN mais recentemente usado pela RM em seu log.
ArchiveTailLsn
O LSN da parte final do arquivo morto do log.
LogContainerSize
O tamanho real de um contêiner de log, em bytes.
HighestVirtualClock
O carimbo de data/hora mais alto associado a um registro de log.
LogContainerCount
O número de contêineres de log.
LogContainerCountMax
O número máximo de contêineres de log.
LogContainerCountMin
O número mínimo de contêineres permitidos no log.
LogGrowthIncrement
O valor pelo qual o log crescerá, que é um número de contêineres ou percentual do tamanho do log; o tipo de crescimento usado é especificado pelo conjunto de sinalizadores no membro Flags .
LogAutoShrinkPercentage
Se a política de redução automática estiver ativa, esse membro especificará a quantidade máxima permitido de espaço livre no log. Se esse membro for zero, a política de redução automática não estará ativa.
Flags
Esse membro pode ser um ou mais dos valores a seguir.
| Value | Meaning |
|---|---|
|
Se o sinalizador estiver definido, o log da RM poderá reduzir o máximo possível. Este sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Indica o tipo de valor em LogGrowthIncrement. Se esse sinalizador estiver definido, LogGrowthIncrement será um número de contêineres. Este sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Indica o tipo de valor em LogGrowthIncrement. Se esse sinalizador estiver definido, LogGrowthIncrement será uma porcentagem. Esta bandeira é mutuamente exclusiva com TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Indica que o log da RM pode crescer sem limites. Este sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Indica o estado atual do sinalizador de redefinição de RM. Se isso estiver definido, o RM será redefinido na próxima vez que for iniciado. Esse sinalizador só é válido para RMs padrão, não RMs secundárias. Este sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START. |
|
Indica o estado atual do sinalizador de redefinição de RM. Se isso estiver definido, a RM não será redefinida na próxima vez que for iniciada. Esse sinalizador só é válido para RMs padrão, não RMs secundárias. Este sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_RESET_RM_AT_NEXT_START. |
|
Indica que o 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 tem suporte pelo RM padrão no volume do sistema. |
|
Indica que o 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. |
LoggingMode
O modo de registro em log atual.
| Value | Meaning |
|---|---|
|
O registro em log simples é usado. |
|
O log completo é usado |
Reserved
Reservado.
RmState
O estado do RM. Os valores válidos são os seguintes.
LogCapacity
A capacidade total do log, em bytes.
LogFree
O número de bytes gratuitos no log.
TopsSize
O tamanho do arquivo $Tops, em bytes.
TopsUsed
A quantidade do arquivo $Tops que está em uso, em bytes.
TransactionCount
O número de transações ativas, no momento em que a consulta foi emitida.
OnePCCount
O número de operações de confirmação de fase única que ocorreram nesta RM.
TwoPCCount
O número de operações de confirmação em duas fases que ocorreram nesta RM.
NumberLogFileFull
O número de vezes que o log dessa RM ficou cheio.
OldestTransactionAge
O comprimento da transação ativa mais antiga, em milissegundos.
RMName
O GUID que indica o nome dessa RM.
TmLogPathOffset
O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em NULL que contém o caminho para o log da TM.
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Header | winioctl.h (inclua Windows.h) |