C++ Syntax

bool

MKI_FileSetPointer(

HANDLE f_hFileHandle,

__int64 f_nOffset,

DWORD f_dwMode );

Moves the file pointer of the given file, i.e. the current position for reading or writing inside that file.

This procedure does not support the additional disk read and write cache, i.e. it may not be used after calling either MKI_FileReadInitDisk or MKI_FileReadInitMemory (for read-only files), or MKI_FileWriteInitNull, MKI_FileWriteInitDisk or MKI_FileWriteInitMemory (for write-only files) !!!

When you have to start reading within a file using the additional read cache, use MKI_FileReadInitDiskOffset to initialize instead of MKI_FileReadInitDisk.

Parameters

FileHandle

[HANDLE] File handle of a previously opened file whose file pointer is to be moved.

Offset

[__int64] Relative movement of the file pointer in bytes.

Mode

[DWORD] Specifies the starting point for the file pointer move. This parameter can be one of the following values:

FILE_BEGIN

The starting point is zero or the beginning of the file. If FILE_BEGIN is specified, Offset is interpreted as an unsigned location for the new file pointer.

FILE_CURRENT

The current value of the file pointer is the starting point.

FILE_END

The current end-of-file position is the starting point.

Return Value

Returns true if the file pointer has been moved successfully, else false (indicating that the given file pointer position is invalid).