共用方式為

PathRenameExtensionW 函式 （shlwapi.h）

  • 發行項

以新的擴展名取代檔名的擴展名。 如果檔名不包含擴展名，擴展名將會附加至字串的結尾。

注意 誤用此函式可能會導致緩衝區滿溢。 我們建議使用更安全 的 pathCchRenameExtension 函式。
 

語法

BOOL PathRenameExtensionW(
  [in, out] LPWSTR  pszPath,
  [in]      LPCWSTR pszExt
);

參數

[in, out] pszPath

類型：LPTSTR

要取代延伸模組之長度為 null 的字串指標MAX_PATH。

[in] pszExt

類型：LPCTSTR

包含 『.』 字元的字元緩衝區指標，後面接著新的延伸模組。

傳回值

類型：BOOL

如果成功，則傳回非零，如果新的路徑和擴展名超過MAX_PATH個字元，則傳回零。

言論

注意

shlwapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 PathRenameExtension 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll （4.71 版或更新版本）