Funzione LZSeek (lzexpand.h)

Articolo
03/05/2024

Sposta un puntatore al file il numero specificato di byte da una posizione iniziale.

Sintassi

LONG LZSeek(
  [in] INT  hFile,
  [in] LONG lOffset,
  [in] INT  iOrigin
);

Parametri

[in] hFile

Handle per il file.

[in] lOffset

Numero di byte in base al quale spostare il puntatore del file.

[in] iOrigin

Posizione iniziale del puntatore. Questo parametro deve essere uno dei valori seguenti.

Valore	Significato
0	Sposta il puntatore di file lOffset byte dall'inizio del file.
1	Sposta il puntatore al file lOffset byte dalla posizione corrente.
2	Sposta il puntatore al file lOffset byte dalla fine del file.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica l'offset dall'inizio del file alla nuova posizione del puntatore.

Se la funzione ha esito negativo, il valore restituito è un codice LZERROR_*. Questi codici hanno valori minori di zero. Si noti che LZSeek 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 LZSeek 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_BADVALUE	Uno dei parametri non è compreso nell'intervallo di valori accettabili.
LZERROR_GLOBLOCK	L'handle di file LZ non può essere bloccato.

Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

L'handle identificato dal parametro hFile deve essere recuperato chiamando la funzione LZInit o LZOpenFile .

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

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

Condividi tramite