_llseek, fonction (winbase.h)

Article
08/27/2023

[Cette fonction est fournie à des fins de compatibilité avec les versions 16 bits de Windows. Les nouvelles applications doivent utiliser la fonction SetFilePointer .]

Repositionne le pointeur de fichier pour le fichier spécifié.

Syntaxe

LONG _llseek(
  HFILE hFile,
  LONG  lOffset,
  int   iOrigin
);

Paramètres

hFile

Handle pour un fichier ouvert. Ce handle est créé par _lcreat.

lOffset

Nombre d’octets que le pointeur de fichier doit déplacer.

iOrigin

Point de départ et direction dans laquelle le pointeur sera déplacé.

Ce paramètre doit être défini sur l’une des valeurs suivantes.

Valeur	Signification
0	Déplace le pointeur à partir du début du fichier.
1	Déplace le fichier à partir de son emplacement actuel.
2	Déplace le pointeur à partir de la fin du fichier.

Valeur retournée

Si la fonction réussit, la valeur de retour spécifie le nouveau décalage. Sinon, la valeur de retour est HFILE_ERROR. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .

Remarques

Lorsqu’un fichier est initialement ouvert, le pointeur de fichier est défini sur le début du fichier. La fonction _llseek déplace le pointeur sans lire les données, ce qui permet un accès aléatoire au contenu du fichier.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

SetFilePointer

Partager via