Función LZCopy (lzexpand.h)
Copia un archivo de origen en un archivo de destino. Si el algoritmo de Lempel-Ziv comprime el archivo de origen, esta función crea un archivo de destino descomprimido. Si el archivo de origen no está comprimido, esta función duplica el archivo original.
Sintaxis
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
Parámetros
[in] hfSource
Identificador del archivo de origen.
[in] hfDest
Identificador del archivo de destino.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto especifica el tamaño, en bytes, del archivo de destino.
Si se produce un error en la función, el valor devuelto es un código LZERROR_*. Estos códigos tienen valores inferiores a cero. Tenga en cuenta que LZCopy no llama a SetLastError ni a SetLastErrorEx; por lo tanto, su error no afecta al código de último error de un subproceso.
A continuación se muestra una lista de códigos de error que LZCopy puede devolver tras un error.
| Código devuelto | Descripción |
|---|---|
|
El identificador que identifica el archivo de origen no es válido. No se puede leer el archivo. |
|
El identificador que identifica el archivo de destino no es válido. No se puede escribir el archivo. |
|
No se ha superado el número máximo de archivos comprimidos abiertos o no se puede asignar memoria local. |
|
El identificador de archivo LZ no se puede bloquear. |
|
El formato de archivo de origen no es válido. |
No hay información de error extendida para esta función; no llame a GetLastError.
Comentarios
Los identificadores que identifican los archivos de origen y destino deben recuperarse mediante una llamada a la función LZInit o LZOpenFile .
Si la función se realiza correctamente, el archivo identificado por el parámetro hfDest siempre está sin comprimir.
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
| Tecnología | Compatible |
|---|---|
| Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | Sí |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Sí |
| Sistema de archivos de Volumen compartido de clúster (CsvFS) | Sí |
| Sistema de archivos resistente a errores (ReFS) | Sí |
CsvFs realizará la E/S redirigida para los archivos comprimidos.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | lzexpand.h (incluye Windows.h) |
| Library | Lz32.lib |
| Archivo DLL | Lz32.dll |
Consulte también
Compresión y descompresión de archivos