función _llseek (winbase.h)

  • Artículo

[Esta función se proporciona para la compatibilidad con versiones de 16 bits de Windows. Las nuevas aplicaciones deben usar la función SetFilePointer .]

Cambia la posición del puntero de archivo para el archivo especificado.

Sintaxis

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

Parámetros

hFile

Identificador de un archivo abierto. Este identificador se crea mediante _lcreat.

lOffset

Número de bytes que se va a mover el puntero de archivo.

iOrigin

El punto inicial y la dirección en que se moverá el puntero.

Este parámetro debe establecerse en uno de los valores siguientes.

Valor Significado
0
 Mueve el puntero desde el principio del archivo.
1
 Mueve el archivo desde su ubicación actual.
2
 Mueve el puntero desde el final del archivo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto especifica el nuevo desplazamiento. De lo contrario, el valor devuelto es HFILE_ERROR. Para obtener información de error extendida, use la función GetLastError .

Comentarios

Cuando se abre un archivo inicialmente, el puntero de archivo se establece en el principio del archivo. La función _llseek mueve el puntero sin leer datos, lo que permite el acceso aleatorio al contenido del archivo.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

SetFilePointer