Compartilhar via


FSCTL_TXFS_GET_TRANSACTED_VERSION IOCTL (winioctl.h)

Observação

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.

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.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                     // handle to device
  FSCTL_TXFS_GET_TRANSACTED_VERSION,    // dwIoControlCode
  NULL,                                 // lpInBuffer
  0,                                    // nInBufferSize
  (LPVOID) lpOutBuffer,                 // output buffer
  (DWORD) nOutBufferSize,               // size of output buffer
  (LPDWORD) lpBytesReturned,            // number of bytes returned
  NULL                                  // OVERLAPPED structure
);

Comentários

FSCTL_TXFS_GET_TRANSACTED_VERSION é uma operação síncrona.

Esse código de controle pode ser usado para acompanhar a versão mais recente de um arquivo base. Para um identificador especificado, a versão base é sempre o valor base retornado quando o identificador foi aberto, mas a versão mais recente é alterada com base em quaisquer operações de confirmação feitas por outra transação. Se o identificador for fechado e aberto novamente, a versão base e a versão mais recente serão atualizadas para novos valores e quaisquer operações de confirmação subsequentes da outra transação alterarão a versão mais recente.

Se você tentar recuperar a versão da raiz de um gerenciador de recursos, o valor TXFS_TRANSACTED_VERSION_NONTRANSACTED será retornado.

Refs: Não há suporte para esse código.

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