共用方式為

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 [僅限桌面應用程式]
目標平台 Windows
標頭 mmiscapi.h (包含 mmiscapi.h、Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll