Compartilhar via


FSCTL_DUPLICATE_EXTENTS_TO_FILE IOCTL (winioctl.h)

Instrui o sistema de arquivos a copiar um intervalo de bytes de arquivo em nome de um aplicativo. O arquivo de destino pode ser igual ou diferente do arquivo de origem. Consulte Bloquear Clonagem para obter mais informações.

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

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

Comentários

Para obter as implicações de E/S sobreposta nesta operação, consulte a seção Comentários do tópico DeviceIoControl .

Consulte Bloquear Clonagem para obter mais informações sobre essa operação.

Em Windows Server 2016, essa função é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (Server Message Block) 3.1.1 Sim
TFO (Failover Transparente) do SMB 3.1.1 Sim
SMB 3.1.1 com SoFS (Compartilhamentos de Arquivos de Expansão) Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim

Requisitos

   
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também