Fonction LZSeek (lzexpand.h)

  • Article

Déplace un pointeur de fichier du nombre d’octets spécifié à partir d’une position de départ.

Syntaxe

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

Paramètres

[in] hFile

Descripteur du fichier.

[in] lOffset

Nombre d’octets par lesquels déplacer le pointeur de fichier.

[in] iOrigin

Position de départ du pointeur. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
0
 Déplace le pointeur de fichier lOffset octets à partir du début du fichier.
1
 Déplace le pointeur de fichier lOffset octets à partir de la position actuelle.
2
 Déplace le pointeur de fichier lOffset octets à partir de la fin du fichier.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie le décalage entre le début du fichier et la nouvelle position du pointeur.

Si la fonction échoue, la valeur de retour est un code LZERROR_*. Ces codes ont des valeurs inférieures à zéro. Notez que LZSeek n’appelle ni SetLastError, ni SetLastErrorEx ; par conséquent, son échec n’affecte pas le code de dernière erreur d’un thread.

Voici la liste des codes d’erreur que LZSeek peut retourner en cas d’échec.

Code de retour Description
LZERROR_BADINHANDLE
 Le handle identifiant le fichier source n’est pas valide. Impossible de lire le fichier.
LZERROR_BADVALUE
 L’un des paramètres se trouve en dehors de la plage des valeurs acceptables.
LZERROR_GLOBLOCK
 Le handle de fichier LZ ne peut pas être verrouillé.
 

Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.

Remarques

Le handle identifié par le paramètre hFile doit être récupéré en appelant la fonction LZInit ou LZOpenFile .

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 Oui
Basculement transparent SMB 3.0 (TFO) Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) Oui
Système de fichiers du volume partagé de cluster (CsvFS) Oui
Système de fichiers résilient (ReFS) Oui
 

CsvFs effectue les E/S redirigées pour les fichiers compressés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête lzexpand.h (inclure Windows.h)
Bibliothèque Lz32.lib
DLL Lz32.dll

Voir aussi

Compression et décompression de fichiers

Fonctions de gestion des fichiers

LZInit

LZOpenFile