Funzione LZInit (lzexpand.h)
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 |
|---|---|
|
L'handle che identifica il file di origine non è valido. Impossibile leggere il file. |
|
Il numero massimo di file compressi aperti è stato superato o non è possibile allocare memoria locale. |
|
Impossibile bloccare l'handle di file LZ. |
|
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 |