mmioRename 函数 (mmiscapi.h)

mmioRename 函数将重命名指定的文件。

语法

MMRESULT mmioRename(
  LPCSTR         pszFileName,
  LPCSTR         pszNewFileName,
  const MMIOINFO *pmmioinfo,
  DWORD          fdwRename
);

parameters

pszFileName

指向包含要重命名的文件文件名的字符串的指针。

pszNewFileName

指向包含新文件名的字符串的指针。

pmmioinfo

指向 MMIOINFO 结构的指针,该结构包含 mmioRename 使用的额外参数。 如果此参数不为 NULL,则它引用的 MMIOINFO 结构的所有未使用成员都必须设置为零,包括保留成员。

fdwRename

重命名操作的标志。 此参数应设置为零。

返回值

如果重命名了文件,则返回零。 否则,返回从 mmioRename 或 I/O 过程返回的错误代码。

要求

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