estrutura TXFS_QUERY_RM_INFORMATION (winioctl.h)
[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do seu 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 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;
Membros
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 usado mais recentemente pelo 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
A quantidade em que o log crescerá, que é um número de contêineres ou uma porcentagem do tamanho do log; o tipo de crescimento usado é especificado pelos sinalizadores definidos no membro Flags .
LogAutoShrinkPercentage
Se a política de redução automática estiver ativa, esse membro especificará a quantidade máxima permitida 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.
| Valor | Significado |
|---|---|
|
Se o sinalizador estiver definido, o log do RM poderá ser reduzido o mais longe possível. Esse 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. Esse 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. Esse sinalizador é mutuamente exclusivo com TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Indica que o log do RM pode crescer sem limites. Esse 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 for 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ários. Esse 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 for definido, o RM não será redefinido na próxima vez que for iniciado. Esse sinalizador só é válido para RMs padrão, não RMs secundários. Esse 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 pelo RM padrão no volume do sistema. |
LoggingMode
O modo de registro em log atual.
| Valor | Significado |
|---|---|
|
O registro em log simples é usado. |
|
O log completo é usado |
Reserved
Reservado.
RmState
O estado do RM. Os valores válidos são da seguinte maneira.
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 nesse RM.
TwoPCCount
O número de operações de confirmação em duas fases que ocorreram nesse 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 desse 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 do TM.
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) |