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 代码，包括以下内容。

返回代码	说明
E_INVALIDARG	pszPath 或 pszMore 为 NULL，cchPath 为 0，或 cchPath 大于 PATHCCH_MAX_CCH。
PATHCCH_E_FILENAME_TOO_LONG	生成的字符串将超过 PATHCCH_MAX_CCH。
E_OUTOFMEMORY	函数无法分配所需大小的缓冲区。

此函数在两个字符串之间插入反斜杠（如果其中一个字符串尚不存在）。