XXX_Seek

This function moves the data pointer in the device.

Syntax

DWORD XXX_Seek( DWORD hOpenContext long Amount WORD Type );

Parameters

hOpenContext

Amount

Specifies the number of bytes to move the data pointer in the device. A positive value moves the data pointer toward the end of the file, and a negative value moves it toward the beginning.

Type

Specifies the starting point for the data pointer:

FILE_BEGIN

Indicates that the starting point is 0 or the beginning of the file.

FILE_CURRENT

Indicates that the current value of the file pointer is the starting point.

FILE_END

Indicates that the current end-of-file position is the starting point.

Return Values

The device’s new data pointer indicates success. A value of –1 indicates failure.

Remarks

An application calls the SetFilePointer function to move the data pointer in the device. The operating system, in turn, invokes this function. If your device is capable of being opened multiple times, this function modifies only the data pointer for the instance specified by hOpenContext.