Funzione LZRead (lzexpand.h)

Articolo
08/24/2023

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
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	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