共用方式為

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
E_INVALIDARG
 pszPath 或 pszMore 為 NULL、cchPath 為 0，或 cchPath 大於 PATHCCH_MAX_CCH。
PATHCCH_E_FILENAME_TOO_LONG
 產生的字串會超過 PATHCCH_MAX_CCH。
E_OUTOFMEMORY
 函式無法配置必要大小的緩衝區。

備註

如果兩個字串不存在，此函式會在兩個字元串之間插入反斜杠。

規格需求

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

另請參閱

PathCchAppendEx