Función CreateDecompressor (compressapi.h)

Genera un nuevo DECOMPRESSOR_HANDLE.

Sintaxis

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

Parámetros

[in] Algorithm

Tipo de algoritmo de compresión y modo que va a usar este descomprimor.

Este parámetro puede tener uno de los siguientes valores opcionalmente combinados con la marca COMPRESS_RAW . Use un operador "OR bit a bit" para incluir COMPRESS_RAW y para crear un descomprimor en modo de bloque. Si no se incluye COMPRESS_RAW, compression API crea un descomprimor en modo de búfer. Para obtener más información sobre cómo seleccionar un algoritmo de compresión y un modo, consulte Uso de la API de compresión.

Valor Significado
COMPRESS_ALGORITHM_MSZIP
2
Algoritmo de compresión MSZIP
COMPRESS_ALGORITHM_XPRESS
3
Algoritmo de compresión XPRESS
COMPRESS_ALGORITHM_XPRESS_HUFF
4
Algoritmo de compresión XPRESS con codificación Huffman
COMPRESS_ALGORITHM_LZMS
5
Algoritmo de compresión LZMS

[in, optional] AllocationRoutines

Rutinas opcionales de asignación y desasignación de memoria en una estructura de COMPRESS_ALLOCATION_ROUTINES .

[out] DecompressorHandle

Si la función se realiza correctamente, el identificador del descomprimor especificado.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero. Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si se produce un error en el algoritmo de compresión por algún motivo interno, el error de GetLastError puede ser ERROR_FUNCTION_FAILED. Si el sistema no encuentra ningún algoritmo de compresión que coincida con el nombre y la versión especificados, el error puede ser ERROR_NOT_SUPPORTED.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado compressapi.h
Library Cabinet.lib
Archivo DLL Cabinet.dll

Consulte también

COMPRESS_ALLOCATION_ROUTINES

Funciones de API de compresión