mmioSeek 函数 (mmiscapi.h)

  • 项目

mmioSeek 函数更改使用 mmioOpen 函数打开的文件中的当前文件位置。

语法

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

parameters

hmmio

要查找的文件的文件句柄。

lOffset

用于更改文件位置的偏移量。

iOrigin

指示如何解释 lOffset 指定的偏移量的标志。 定义了以下值：

名称 说明
SEEK_CUR
 从当前文件位置查找 lOffset 字节。
SEEK_END
 从文件末尾查找 lOffset 字节。
SEEK_SET
 从文件开头查找 lOffset 字节。

返回值

返回相对于文件开头的新文件位置（以字节为单位）。 如果出现错误，则返回值为 –1。

注解

在文件中查找无效位置（例如文件末尾之后）不会导致 mmioSeek 返回错误，但可能会导致文件上的后续 I/O 操作失败。

若要查找文件的末尾，请调用 mmioSeek ， 并将 lOffset 设置为零， 并将 iOrigin 设置为 SEEK_END。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmiscapi.h (包括 Mmiscapi.h、Windows.h)
Library Winmm.lib
DLL Winmm.dll