共用方式為

PathCchRenameExtension 函式 (pathcch.h)

  • 發行項

以新的擴展名取代路徑字串結尾的檔名擴展名。 如果路徑字串未以延伸模組結尾，則會新增新的延伸模組。

此函式與 PathRenameExtension 不同，因為它接受具有 “\”、“\？” 和 “\？\UNC” 前置詞的路徑。

注意 此函式應該用來取代 PathRenameExtension ，以防止緩衝區溢出的可能性。

語法

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

參數

[in, out] pszPath

路徑字串的指標。 當此函式成功傳回時，這個值會指向相同的字串，但已重新命名或新增擴充功能。

[in] cchPath

pszPath 所指向的緩衝區大小，以字元為單位。

[in] pszExt

新延伸字串的指標。 前置 '.' 字元是選擇性的。 如果空字串 (“”“) ，則會移除路徑字串中的任何現有延伸。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 pathcch.h
程式庫 Pathcch.lib