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 標頭會根據 UNICODE 預處理器常數的定義,將 PathRenameExtension 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | shlwapi.h |
連結庫 | Shlwapi.lib |
DLL | Shlwapi.dll (4.71 版或更新版本) |