_llseek
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