Compartilhar via


FSCTL_SET_COMPRESSION IOCTL (winioctl.h)

Define o estado de compactação de um arquivo ou diretório em um volume cujo sistema de arquivos dá suporte à compactação por arquivo e por diretório. Você pode usar FSCTL_SET_COMPRESSION para compactar ou descompactar um arquivo ou diretório nesse volume.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to file or directory
  FSCTL_SET_COMPRESSION,            // 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

O algoritmo de compactação LZNT1 é o único algoritmo de compactação implementado. Como resultado, o algoritmo de compactação LZNT1 é usado como o método de compactação DEFAULT.

Se o sistema de arquivos do volume que contém o arquivo ou diretório especificado não oferecer suporte a compactação por arquivo ou por diretório, a operação falhará.

A alteração do estado de compactação do arquivo ou diretório ocorre de forma síncrona com a chamada para DeviceIoControl.

Para recuperar o estado de compactação de um arquivo ou diretório, use o código de controle FSCTL_GET_COMPRESSION .

Para recuperar o atributo de compactação de um arquivo ou diretório, use a função GetFileAttributes . O atributo de compactação indica se um arquivo ou diretório é compactado. O estado de compactação indica se um arquivo ou diretório é compactado e, se for, o formato dos dados compactados.

Os diretórios não são realmente compactados por essa operação. Em vez disso, a operação define o estado padrão para arquivos criados no diretório a serem compactados.

Observe que os carimbos de data/hora podem não ser atualizados corretamente para um arquivo remoto. Para garantir resultados consistentes, use E/S sem cofres.

Há suporte para compactação de arquivos de um tamanho máximo não compactado de 30 gigabytes.

Em Windows 8 e Windows Server 2012, esse código é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Sim
TFO (Failover transparente) do SMB 3.0 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Confira o comentário
ReFS (Sistema de Arquivos Resiliente) No

CsvFs não dá suporte à criação de um diretório compactado. CsvFs permite tornar o arquivo compactado somente quando o arquivo é aberto exclusivamente por um nó. O Failover Transparente do SMB 3.0 e o Scale-Out não dão suporte a arquivos compactados NTFS. A chamada FSCTL não está bloqueada, mas não tem suporte."

Operações transacionadas

Não é possível alterar o estado de compactação de um arquivo aberto com CreateFileTransacted.

Para obter mais informações sobre transações, consulte NTFS transacional.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também