Windows Win32Arquivos & E/Skernel32.dll
SetFilePointerEx
Reposiciona o cursor de leitura/escrita de um arquivo, com suporte a deslocamentos de 64 bits.
Descrição
Sucessora de SetFilePointer (32-bit); equivalente funcional a `lseek`.
Header:
fileapi.hDLL: kernel32.dllNative API: NtSetInformationFileAssinatura
BOOL SetFilePointerEx(
HANDLE hFile,
LARGE_INTEGER liDistanceToMove,
PLARGE_INTEGER lpNewFilePointer,
DWORD dwMoveMethod
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| hFile | HANDLE | Handle do arquivo. |
| liDistanceToMove | LARGE_INTEGER | Deslocamento, interpretado conforme dwMoveMethod. |
| lpNewFilePointer | PLARGE_INTEGER | Se não for NULL, recebe a nova posição absoluta. |
| dwMoveMethod | DWORD | FILE_BEGIN, FILE_CURRENT ou FILE_END. |
Valor de retorno
Diferente de zero em sucesso; 0 em erro (consulte GetLastError).
Códigos de erro (GetLastError)
- ERROR_INVALID_HANDLE(6)
- O identificador (handle) informado é inválido.
- ERROR_NEGATIVE_SEEK(131)
- Tentativa de mover o ponteiro de arquivo antes do início do arquivo.
Relacionadas
Equivalente em Linux x86_64