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


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

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

Синтаксис

MMRESULT mmioRenameW(
  LPCWSTR     pszFileName,
  LPCWSTR     pszNewFileName,
  LPCMMIOINFO pmmioinfo,
  DWORD       fdwRename
);

Параметры

pszFileName

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

pszNewFileName

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

pmmioinfo

Указатель на структуру MMIOINFO , содержащую дополнительные параметры, используемые mmioRename. Если этот параметр не NULL, все неиспользуемые члены структуры MMIOINFO должны быть равны нулю, включая зарезервированные элементы.

fdwRename

Флаги для операции переименования. Этот параметр должен иметь значение нулю.

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

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

Замечания

Заметка

Заголовок mmiscapi.h определяет mmioRename как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка mmiscapi.h (include Mmiscapi.h, Windows.h)
библиотеки Winmm.lib
DLL Winmm.dll