Función LZInit (lzexpand.h)
Asigna memoria a las estructuras de datos internas necesarias para descomprimir archivos y, luego, las crea e inicializa.
Sintaxis
INT LZInit(
[in] INT hfSource
);
Parámetros
[in] hfSource
Identificador del archivo.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un nuevo identificador de archivo LZ.
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 LZInit 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 la lista de códigos de error que LZInit 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. |
|
No se puede asignar 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 archivo se comprime con un algoritmo de compresión no reconocido. |
No hay información de error extendida para esta función; no llame a GetLastError.
Comentarios
Un máximo de 16 archivos comprimidos se puede abrir en cualquier momento dado. Del mismo modo, un máximo de 16 archivos sin comprimir se puede abrir en cualquier momento dado. Una aplicación debe tener cuidado de cerrar el identificador devuelto por LZInit cuando haya terminado con el archivo; De lo contrario, la aplicación puede alcanzar accidentalmente el límite de 16 archivos.
El identificador que devuelve esta función solo es compatible con las funciones de Lz32.dll; no debe usarse para otras operaciones de archivo.
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 (incluya Windows.h) |
| Library | Lz32.lib |
| Archivo DLL | Lz32.dll |