Compartilhar via

FSCTL_TXFS_WRITE_BACKUP_INFORMATION IOCTL (winioctl.h)

  • Artigo

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.

Grava informações específicas do NTFS transacional (TxF) 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.

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

Comentários

FSCTL_TXFS_WRITE_BACKUP_INFORMATION é uma operação síncrona.

Esse código de controle pode ser usado por funções de backup e aplicativos, como Win32 BackupRead e por gravadores VSS (Serviço de Instantâneo 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

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