Compartir a través de

Función CreateCompressor (compressapi.h)

  • Artículo

Genera un nuevo COMPRESSOR_HANDLE.

Sintaxis

BOOL CreateCompressor(
  [in]           DWORD                         Algorithm,
  [in, optional] PCOMPRESS_ALLOCATION_ROUTINES AllocationRoutines,
  [out]          PCOMPRESSOR_HANDLE            CompressorHandle
);

Parámetros

[in] Algorithm

Tipo de algoritmo de compresión y modo que va a utilizar este compresor.

Este parámetro puede tener uno de los siguientes valores opcionalmente combinados con la marca COMPRESS_RAW . Utilice un operador "OR bit a bit" para incluir COMPRESS_RAW y para crear un compresor en modo de bloque. Si no se incluye COMPRESS_RAW, compression API crea un compresor de 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] CompressorHandle

Si la función se realiza correctamente, el controlador al compresor 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