共用方式為

PathCchAddExtension 函式 (pathcch.h)

  • 發行項

將擴展名新增至路徑字串。

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

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

語法

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

參數

[in, out] pszPath

路徑字串的指標。 當此函式成功傳回時，緩衝區會包含具有附加延伸模組的字元串。 此值不應為 NULL。

注意 如果原始字串已經有擴展名，則不會新增任何新的擴展名，且原始字串不會變更。

[in] cchPath

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

[in] pszExt

擴展名字串的指標。 這個字串可以使用或不含前一個句號 (“.ext” 或 “ext”) 來指定。

傳回值

此函式會傳回 HRESULT 程式代碼，包括下列專案。

傳回碼 描述
S_OK
 此函數已成功。 請注意，這也會包含空白延伸模組的大小寫，例如沒有後面的字元的句號。 在此情況下，原始字串會傳回未變更。
E_INVALIDARG
 此值可能是由數件事所造成，例如 將 pszPath 參數設定為 NULL、 設定 為 0 或大於 PATHCCH_MAX_CCH的值，或是包含不合法字元的延伸字串，或不是有效的擴展名。
S_FALSE
 原始字串已經有擴展名。
PATHCCH_E_FILENAME_TOO_LONG
 緩衝區太小而無法保存傳回的字串。

規格需求

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