通过

mmioRenameW 函数 （mmiscapi.h）

  • 项目

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

语法

MMRESULT mmioRenameW(
  LPCWSTR     pszFileName,
  LPCWSTR     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 [仅限桌面应用]
目标平台 窗户
标头 mmiscapi.h （包括 Mmiscapi.h、Windows.h）
库 Winmm.lib
DLL Winmm.dll