Partilhar via


Códigos de controle TxF

[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, consulte Alternativas ao uso do NTFS transacional.]

O TxF (NTFS transacional) fornece os seguintes códigos de controle.

Nesta seção

Código de controle Descrição
FSCTL_TXFS_CREATE_MINIVERSION
Cria uma nova miniversão para o arquivo especificado.
As miniversões permitem que você se refira a um instantâneo do arquivo durante uma transação. As miniversões são descartadas quando uma transação é confirmada ou revertida.
FSCTL_TXFS_GET_METADATA_INFO
Recupera metadados TxF (Transacted NTFS) para um arquivo e o GUID da transação que bloqueou o arquivo especificado (se o arquivo estiver bloqueado).
FSCTL_TXFS_GET_TRANSACTED_VERSION
Retorna uma estrutura TXFS_GET_TRANSACTED_VERSION . A estrutura identifica a versão confirmada mais recentemente do arquivo especificado, o número de versão do identificador.
FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES
Retorna uma lista de todos os arquivos bloqueados atualmente pela transação especificada. Se o valor retornado for ERROR_MORE_DATA, ele retornará o comprimento do buffer necessário para manter a lista completa de arquivos no momento dessa chamada.
FSCTL_TXFS_LIST_TRANSACTIONS
Retorna uma lista de todas as transações atualmente envolvidas no gerenciador de recursos especificado.
FSCTL_TXFS_MODIFY_RM
Define o modo de log e as informações de parâmetro de log para um RM (gerenciador de recursos secundário).
FSCTL_TXFS_QUERY_RM_INFORMATION
Recupera informações de um gerenciador de recursos (RM).
FSCTL_TXFS_READ_BACKUP_INFORMATION
Retorna informações específicas do TxF (NTFS transacional) para o arquivo especificado.
FSCTL_TXFS_SAVEPOINT_INFORMATION
O código de controle FSCTL_TXFS_SAVEPOINT_INFORMATION controla a configuração, a limpeza e a reversão para o ponto de salvamento especificado.
Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.
FSCTL_TXFS_TRANSACTION_ACTIVE
Retorna um valor booliano que indica se havia transações ativas no volume associado quando o instantâneo foi obtido. Essa chamada só é válida para volumes de instantâneo somente leitura.
FSCTL_TXFS_WRITE_BACKUP_INFORMATION
Grava informações específicas do TxF (NTFS transacional) em um arquivo especificado. O membro Buffer da estrutura TXFS_WRITE_BACKUP_INFORMATION deve ser o membro Buffer da estrutura TXFS_READ_BACKUP_INFORMATION_OUT retornada por FSCTL_TXFS_READ_BACKUP_INFORMATION.