Compartilhar via


FSCTL_TXFS_CREATE_MINIVERSION 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.

Cria uma nova miniversão do arquivo especificado. As miniversões permitem que você faça referência a um instantâneo do arquivo durante uma transação. As miniversões são descartadas quando uma transação é confirmada ou revertida.

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

Comentários

FSCTL_TXFS_CREATE_MINIVERSION é uma operação síncrona.

Se você tentar criar uma miniversão em uma transação não ativa, ERROR_INVALID_TRANSACTION será retornado.

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

Requisitos

   
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