 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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_Openfunction 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 SetFilePointerfunction 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