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é SetLastErrorSetLastErrorEx; 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
LZERROR_BADINHANDLE
L'handle che identifica il file di origine non è valido. Impossibile leggere il file.
LZERROR_BADOUTHANDLE
L'handle che identifica il file di destinazione non è valido. Impossibile scrivere il file.
LZERROR_BADVALUE
Uno dei parametri di input non è valido.
LZERROR_GLOBALLOC
È stato superato il numero massimo di file compressi aperti o non è possibile allocare memoria locale.
LZERROR_GLOBLOCK
L'handle di file LZ non può essere bloccato.
LZERROR_READ
Il formato del file di origine non è valido.
LZERROR_WRITE
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
Failover trasparente SMB 3.0 (TFO)
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)
File system del volume condiviso cluster (CsvFS)
Resilient File System (ReFS)
 

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

Vedi anche

Compressione e decompressione dei file

Funzioni di gestione file

LZInit

LZOpenFile

LZSeek