Funzione LZSeek (lzexpand.h)
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 |
|---|---|
|
Sposta il puntatore di file lOffset byte dall'inizio del file. |
|
Sposta il puntatore al file lOffset byte dalla posizione corrente. |
|
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 |
|---|---|
|
L'handle che identifica il file di origine non è valido. Impossibile leggere il file. |
|
Uno dei parametri non è compreso nell'intervallo di valori accettabili. |
|
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 |