Поделиться через


Функция mmioSeek (mmiscapi.h)

Функция mmioSeek изменяет текущую позицию файла, открытого с помощью функции mmioOpen .

Синтаксис

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

Параметры

hmmio

Дескриптор файла для поиска.

lOffset

Смещение для изменения положения файла.

iOrigin

Флаги, указывающие, как интерпретируется смещение, заданное параметром lOffset . Определены следующие значения:

Имя Описание
SEEK_CUR
Ищет значение lOffset байтов из текущей позиции файла.
SEEK_END
Ищет значение lOffset байтов из конца файла.
SEEK_SET
Ищет значение lOffset байтов от начала файла.

Возвращаемое значение

Возвращает новую позицию файла в байтах относительно начала файла. При возникновении ошибки возвращается значение –1.

Комментарии

Поиск недопустимого расположения в файле, например после конца файла, может не привести к ошибке mmioSeek , но может привести к сбою последующих операций ввода-вывода с файлом.

Чтобы найти конец файла, вызовите mmioSeek с параметром lOffset , равным нулю, а для iOrigin — значение SEEK_END.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mmiscapi.h (включая Mmiscapi.h, Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll