Voltar à lista
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: NtSetInformationFile

Assinatura

BOOL SetFilePointerEx(
    HANDLE hFile,
    LARGE_INTEGER liDistanceToMove,
    PLARGE_INTEGER lpNewFilePointer,
    DWORD dwMoveMethod
);

Parâmetros

ParâmetroTipoDescrição
hFileHANDLEHandle do arquivo.
liDistanceToMoveLARGE_INTEGERDeslocamento, interpretado conforme dwMoveMethod.
lpNewFilePointerPLARGE_INTEGERSe não for NULL, recebe a nova posição absoluta.
dwMoveMethodDWORDFILE_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