Funzione LZCopy (lzexpand.h)
Copia un file di origine in un file di destinazione. Se il file di origine è stato compresso dall'algoritmo Lempel-Ziv, questa funzione crea un file di destinazione decompresso. Se il file di origine non è compresso, questa funzione duplica il file originale.
Sintassi
LONG LZCopy(
[in] INT hfSource,
[in] INT hfDest
);
Parametri
[in] hfSource
Handle per il file di origine.
[in] hfDest
Handle per il file di destinazione.
Valore restituito
Se la funzione ha esito positivo, il valore restituito specifica le dimensioni, in byte, del file di destinazione.
Se la funzione ha esito negativo, il valore restituito è un codice LZERROR_*. Questi codici hanno valori minori di zero. Si noti che LZCopy non chiama né SetLastError né SetLastErrorEx; pertanto, il suo errore non influisce sul codice di ultimo errore di un thread.
Di seguito è riportato un elenco di codici di errore che LZCopy può restituire in caso di errore.
| Codice restituito | Descrizione |
|---|---|
|
L'handle che identifica il file di origine non è valido. Impossibile leggere il file. |
|
L'handle che identifica il file di destinazione non è valido. Impossibile scrivere il file. |
|
È stato superato il numero massimo di file compressi aperti o non è possibile allocare memoria locale. |
|
L'handle di file LZ non può essere bloccato. |
|
Il formato del file di origine non è valido. |
Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.
Commenti
Gli handle che identificano i file di origine e di destinazione devono essere recuperati chiamando la funzione LZInit o LZOpenFile .
Se la funzione ha esito positivo, il file identificato dal parametro hfDest è sempre non compresso.
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 di scalabilità orizzontale (SO) | Sì |
| File system del volume condiviso cluster (CsvFS) | Sì |
| Resilient File System (ReFS) | Sì |
CsvFs eseguirà operazioni di I/O reindirizzate 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 (include Windows.h) |
| Libreria | Lz32.lib |
| DLL | Lz32.dll |