共用方式為

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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 mmiscapi.h （include Mmiscapi.h， Windows.h）
連結庫 Winmm.lib
DLL Winmm.dll