Share via

mmioRenameA 函数 (mmiscapi.h)

  • 项目

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

语法

MMRESULT mmioRenameA(
  LPCSTR      pszFileName,
  LPCSTR      pszNewFileName,
  LPCMMIOINFO pmmioinfo,
  DWORD       fdwRename
);

参数

pszFileName

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

pszNewFileName

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

pmmioinfo

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

fdwRename

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

返回值

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

注解

注意

mmiscapi.h 标头将 mmioRename 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

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