MmioRead

LONG mmioRead( HMMIO hmmio, HPSTR pch, LONG cch );

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

Возвращается число реально считанных байт. Если достигнут конец файла и не может быть считано ни одного байта информации, возвращается нулевое значение. Если при выполнении функции возникла ошибка, то возвращается значение -1.

Аргументы

0. hmmio — дескриптор считываемого файла.

1. pch — указатель на буфер, в который будут записана считанная из файла информация.

2. cch — число байт, которые следует считать из файла.

Примечание

Функция mmioRead считывает указанное число байт из файла, открытого функцией mmioOpen.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

MmioRename

MMRESULT mmioRename( LPCSTR szFilename, LPCSTR szNewFilename, const LPMMIOINFO lpmmioinfo, DWORD dwRenameFlags );

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

В случае успешного переименования файла возвращает нулевое значение. В противном случае функция mmioRename или процедура ввода/вывода возвращают значение ошибки.

Аргументы

0. szFilename — указатель на строку, содержащую старое имя файла.

1. szNewFileName — указатель на строку, содержащую новое имя файла.

2. lpmmioinfo — указатель на объект структуры MMIOINFO, содержащей дополнительные аргументы функции mmioRename. Если данный аргумент имеет ненулевое значение, то все неиспользуемые переменные объекта структуры MMIOINFO должны иметь нулевое значение, включая зарезервированные переменные.

3. dwRenameFlags — флаги, определяющие режим операции переименования. Данный аргумент должен иметь нулевое значение.

Примечание

Функция mmioRename производит переименование указанного файла.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

MmioSeek

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

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

Возвращается новая текущая позиция в файле, измеряемая в байтах от начала файла. Если при выполнении функции возникла ошибка, то возвращается значение -1.

Аргументы

0. hmmio — дескриптор файла в котором производится поиск.

1. lOffset — смещение текущей позиции в файле.

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

• SEEK_CUR — смещение, задаваемое аргументом lOffset, измеряется от текущей позиции файла.

• SEEK_END — смещение, задаваемое аргументом lOffset, измеряется от конца файла.

• SEEK_SET — смещение, задаваемое аргументом lOffset, измеряется от начала файла.

Примечание

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

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

Для определения позиции конца файла можно вызвать функцию mmioSeek, передав в переменной lOffset нулевое значение смещения и установив в переменной iOrigin флаг SEEK_END.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.