Compartilhar via


FSCTL_TXFS_READ_BACKUP_INFORMATION IOCTL (winioctl.h)

Observação

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

Retorna informações específicas do NTFS transacional (TxF) para o arquivo especificado.

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_READ_BACKUP_INFORMATION,   // 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_READ_BACKUP_INFORMATION é uma operação síncrona.

Esse código de controle pode ser usado por funções de backup e aplicativos, como o BackupRead do Win32 e por gravadores do VSS (Serviço de Cópia de Sombra de Volume) que dão suporte a gerenciadores de recursos secundários. Para obter mais informações, consulte Serviço de Cópia de Sombra de Volume.

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