共用方式為

PathRenameExtensionA 函式 (shlwapi.h)

  • 發行項

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

注意 誤用此函式可能會導致緩衝區溢出。 我們建議在其位置使用更安全 的PathCchRenameExtension函 式。
 

語法

BOOL PathRenameExtensionA(
  [in, out] LPSTR  pszPath,
  [in]      LPCSTR pszExt
);

參數

[in, out] pszPath

類型： LPTSTR

長度為 null 的字串指標，MAX_PATH用來取代延伸模組。

[in] pszExt

類型： LPCTSTR

包含 『.』 字元的字元緩衝區指標，後面接著新的擴展名。

傳回值

類型： BOOL

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

備註

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (4.71 版或更新版本)