estrutura TXFS_GET_TRANSACTED_VERSION (winioctl.h)

  • Artigo

[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 sobre a última versão e a versão base do arquivo especificado.

Sintaxe

typedef struct _TXFS_GET_TRANSACTED_VERSION {
  DWORD ThisBaseVersion;
  DWORD LatestVersion;
  WORD  ThisMiniVersion;
  WORD  FirstMiniVersion;
  WORD  LatestMiniVersion;
} TXFS_GET_TRANSACTED_VERSION, *PTXFS_GET_TRANSACTED_VERSION;

Membros

ThisBaseVersion

A versão do arquivo com a qual esse identificador é aberto. Esse membro pode ser um dos valores a seguir.

Valor Significado
TXFS_TRANSACTED_VERSION_NONTRANSACTED
0xFFFFFFFE
 O arquivo não é um arquivo transacionado.
TXFS_TRANSACTED_VERSION_UNCOMMITTED
0xFFFFFFFF
 O arquivo foi aberto como um gravador transacionado.
 

Se o identificador tiver sido aberto como um leitor transacionado, o valor retornado para esse membro será um inteiro positivo que representa o número de versão do arquivo ao qual o identificador está associado.

LatestVersion

A versão confirmada mais recentemente do arquivo.

ThisMiniVersion

Se o identificador para uma miniversão estiver aberto, esse membro conterá a ID da miniversão. Se o identificador não estiver aberto, esse membro será zero (0).

FirstMiniVersion

A primeira miniversão disponível para este arquivo. Se não houver miniversões ou não estiverem visíveis para a transação associada ao identificador de arquivo, esse campo será zero (0).

LatestMiniVersion

A miniversão disponível mais recente para este arquivo. Se não houver miniversões ou não estiverem visíveis para a transação associada ao identificador de arquivo, esse campo será zero (0).

Comentários

O número de versão base permanece o mesmo durante o tempo de vida de um identificador. O número de versão mais recente aumenta desde que um identificador ainda esteja aberto em um arquivo e uma alteração seja confirmada. Quando o identificador é fechado, o número de versão é redefinido para zero.

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)

Confira também

FSCTL_TXFS_GET_TRANSACTED_VERSION