mmioSeek

  • Article

The mmioSeek function changes the current file position in a file opened by using the mmioOpen function.

LONG mmioSeek(
  HMMIO hmmio,  
  LONG lOffset, 
  int iOrigin   
);

Parameters

hmmio

File handle of the file to seek in.

lOffset

Offset to change the file position.

iOrigin

Flags indicating how the offset specified by lOffset is interpreted. The following values are defined:

SEEK_CUR

Seeks to lOffset bytes from the current file position.

SEEK_END

Seeks to lOffset bytes from the end of the file.

SEEK_SET

Seeks to lOffset bytes from the beginning of the file.

Return Values

Returns the new file position, in bytes, relative to the beginning of the file. If there is an error, the return value is - 1.

Remarks

Seeking to an invalid location in the file, such as past the end of the file, might not cause mmioSeek to return an error, but it might cause subsequent I/O operations on the file to fail.

To locate the end of a file, call mmioSeek with lOffset set to zero and iOrigin set to SEEK_END.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Mmsystem.h; include Windows.h.
**  Library:** Use Winmm.lib.

See Also

mmioOpen