The _llseek function repositions the file pointer in a previously opened file. This function is provided for compatibility with 16-bit versions of Windows. Win32-based applications should use the SetFilePointer function.
LONG _llseek(
| HFILE hFile, | // handle to file |
| LONG lOffset, | // number of bytes to move |
| int iOrigin | // position to move from |
| ); |
Parameters
hFile
Identifies the file.
lOffset
Specifies the number of bytes the file pointer is to be moved.
iOrigin
Specifies the starting position and direction of the file pointer. This parameter must be one of the following values:
| Value | Meaning |
| FILE_BEGIN | Moves the file pointer lOffset bytes from the beginning of the file. |
| FILE_CURRENT | Moves the file pointer lOffset bytes from its current position. |
| FILE_END | Moves the file pointer lOffset bytes from the end of the file. |
Return Values
If the function succeeds, the return value specifies the new offset of the pointer, in bytes, from the beginning of the file.
If the function fails, the return value is HFILE_ERROR. To get extended error information, call GetLastError.
Remarks
When a file is initially opened, the file pointer is set to the beginning of the file. The _llseek function moves the pointer an arbitrary amount without reading data, which facilitates random access to the file's contents.
See Also