função _llseek (winbase.h)

[Essa função é fornecida para compatibilidade com versões de 16 bits do Windows. Novos aplicativos devem usar a função SetFilePointer .]

Reposiciona o ponteiro de arquivo para o arquivo especificado.

Sintaxe

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

Parâmetros

hFile

Um identificador para um arquivo aberto. Esse identificador é criado por _lcreat.

lOffset

O número de bytes que o ponteiro do arquivo deve ser movido.

iOrigin

O ponto de partida e a direção em que o ponteiro será movido.

Esse parâmetro deve ser definido como um dos valores a seguir.

Valor Significado
0
Move o ponteiro do início do arquivo.
1
Move o arquivo de seu local atual.
2
Move o ponteiro do final do arquivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará o novo deslocamento. Caso contrário, o valor retornado será HFILE_ERROR. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

Quando um arquivo é aberto inicialmente, o ponteiro do arquivo é definido como o início do arquivo. A função _llseek move o ponteiro sem ler dados, o que permite acesso aleatório ao conteúdo do arquivo.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

SetFilePointer