Funzione LZSeek (lzexpand.h)

  • Articolo

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