Compartilhar via

Função CreateDecompressor (compressapi.h)

  • Artigo

Gera um novo DECOMPRESSOR_HANDLE.

Sintaxe

BOOL CreateDecompressor(
  [in]           DWORD                         Algorithm,
  [in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
  [out]          PDECOMPRESSOR_HANDLE          DecompressorHandle
);

Parâmetros

[in] Algorithm

O tipo de algoritmo de compactação e o modo a ser usado por esse descompactador.

Esse parâmetro pode ter um dos valores a seguir, opcionalmente, combinados com o sinalizador COMPRESS_RAW . Use um operador "OR bit a bit" para incluir COMPRESS_RAW e criar um descompactador de modo de bloco. Se COMPRESS_RAW não estiver incluído, a API de Compactação criará um descompactador de modo de buffer. Para obter mais informações sobre como selecionar um algoritmo e modo de compactação, consulte Usando a API de compactação.

Valor Significado
COMPRESS_ALGORITHM_MSZIP
2
 Algoritmo de compactação MSZIP
COMPRESS_ALGORITHM_XPRESS
3
 Algoritmo de compactação XPRESS
COMPRESS_ALGORITHM_XPRESS_HUFF
4
 Algoritmo de compactação XPRESS com codificação Huffman
COMPRESS_ALGORITHM_LZMS
5
 Algoritmo de compactação LZMS

[in, optional] AllocationRoutines

Rotinas opcionais de alocação e desalocação de memória em uma estrutura COMPRESS_ALLOCATION_ROUTINES .

[out] DecompressorHandle

Se a função for bem-sucedida, o identificador para o descompactador especificado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o algoritmo de compactação falhar por algum motivo interno, o erro de GetLastError poderá ser ERROR_FUNCTION_FAILED. Se o sistema não encontrar nenhum algoritmo de compactação que corresponda ao nome e à versão especificados, o erro poderá ser ERROR_NOT_SUPPORTED.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho compressapi.h
Biblioteca Cabinet.lib
DLL Cabinet.dll

Confira também

COMPRESS_ALLOCATION_ROUTINES

Funções da API de compactação