Funzione LZInit (lzexpand.h)

  • Articolo

Alloca la memoria per le strutture di dati interne necessarie per decomprimere i file e quindi crea e li inizializza.

Sintassi

INT LZInit(
  [in] INT hfSource
);

Parametri

[in] hfSource

Handle per il file.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un nuovo handle di file LZ.

Se la funzione ha esito negativo, il valore restituito è un codice LZERROR_* . Questi codici hanno valori inferiori a zero. Si noti che LZInit chiama né SetLastError né SetLastErrorEx; pertanto, l'errore non influisce sul codice dell'ultimo errore di un thread.

Di seguito è riportato l'elenco dei codici di errore che LZInit può restituire al momento dell'errore.

Codice restituito Descrizione
LZERROR_BADINHANDLE
 L'handle che identifica il file di origine non è valido. Impossibile leggere il file.
LZERROR_GLOBALLOC
 Il numero massimo di file compressi aperti è stato superato o non è possibile allocare memoria locale.
LZERROR_GLOBLOCK
 Impossibile bloccare l'handle di file LZ.
LZERROR_UNKNOWNALG
 Il file viene compresso con un algoritmo di compressione non riconosciuto.
 

Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

È possibile aprire un massimo di 16 file compressi in qualsiasi momento. Analogamente, un massimo di 16 file non compressi può essere aperto in qualsiasi momento. Un'applicazione deve prestare attenzione a chiudere l'handle restituito da LZInit quando viene eseguito usando il file; in caso contrario, l'applicazione può inavvertitamente raggiungere il limite di 16 file.

L'handle restituito da questa funzione è compatibile solo con le funzioni in Lz32.dll; non deve essere usato per altre operazioni di file.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) Sì
File system del volume condiviso del cluster (CsvFS) Sì
File system resiliente (ReFS) Sì
 

CsvFs eseguirà il reindirizzamento di I/O per i file compressi.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione lzexpand.h (includere Windows.h)
Libreria Lz32.lib
DLL Lz32.dll

Vedi anche

Compressione e decompressione dei file

Funzioni di gestione file