Funzione LZRead (lzexpand.h)
Legge (al massimo) il numero specificato di byte da un file e li copia in un buffer.
Sintassi
INT LZRead(
[in] INT hFile,
[out] CHAR *lpBuffer,
[in] INT cbRead
);
Parametri
[in] hFile
Handle per il file.
[out] lpBuffer
Puntatore a un buffer che riceve i byte letti dal file. Assicurarsi che il buffer sia maggiore di cbRead.
[in] cbRead
Numero di byte da leggere.
Valore restituito
Se la funzione ha esito positivo, il valore restituito specifica il numero di byte letti.
Se la funzione ha esito negativo, il valore restituito è un codice LZERROR_*. Questi codici hanno valori minori di zero. Si noti che LZRead chiama né SetLastError né SetLastErrorEx; pertanto, il suo errore non influisce sul codice di ultimo errore di un thread.
Di seguito è riportato l'elenco dei codici di errore che LZRead 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. |
|
Uno dei parametri di input non è valido. |
|
È 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. |
|
Spazio insufficiente per il file di output. |
Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.
Commenti
L'handle che identifica il file deve essere recuperato chiamando la funzione LZInit o LZOpenFile .
Se il file è compresso, LZRead opera su un'immagine espansa del file e copia i byte di dati nel buffer specificato.
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 |