PathCchAppend 函式 (pathcch.h)
將一個路徑附加至另一個路徑的結尾。
此函式與 PathCchAppendEx 不同，因為您受限於長度MAX_PATH的最終路徑。
此函式與 PathAppend 不同，因為它接受具有 “\”、“\？” 和 “\？\UNC” 前置詞的路徑。
注意 此函式或 PathCchAppendEx 應該用來取代 PathAppend ，以防止緩衝區溢出的可能性。
語法
WINPATHCCHAPI HRESULT PathCchAppend(
[in, out] PWSTR pszPath,
[in] size_t cchPath,
[in, optional] PCWSTR pszMore
);
參數
[in, out] pszPath
在專案上，緩衝區的指標包含原始路徑。 當此函式成功傳回時，緩衝區會包含原始路徑加上附加的路徑。
[in] cchPath
pszPath 所指向的緩衝區大小，以字元為單位。
[in, optional] pszMore
要附加至 pszPath 所指向路徑結尾之路徑的指標。 從 “\？” 序列開始的 UNC 路徑會接受並辨識為完整路徑。 這些路徑會取代 pszPath 所指向的字串，而不是附加至該字串。
傳回值
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 程式代碼，包括下列專案。
| 傳回碼 | Description |
|---|---|
|
pszPath 或 pszMore 為 NULL、cchPath 為 0，或 cchPath 大於 PATHCCH_MAX_CCH。 |
|
產生的字串會超過 PATHCCH_MAX_CCH。 |
|
函式無法配置必要大小的緩衝區。 |
備註
如果兩個字串不存在，此函式會在兩個字元串之間插入反斜杠。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | pathcch.h |
| 程式庫 | Pathcch.lib |