XXX_Seek
This function moves the data pointer in the device.
DWORD XXX_Seek(
DWORD hOpenContext,
long Amount,
WORD Type );
Parameters
- hOpenContext
Handle to the open context of the device. The XXX_Open function creates and returns this identifier. - 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:Value Description 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.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.