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.
LONG _llseek(
HFILE hFile,
LONG lOffset,
int iOrigin
);
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 |
---|---|
|
Move o ponteiro do início do arquivo. |
|
Move o arquivo de seu local atual. |
|
Move o ponteiro do final do arquivo. |
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 .
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.
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | winbase.h (inclua Windows.h) |
Biblioteca | Kernel32.lib |
DLL | Kernel32.dll |