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.