共用方式為


PathCchAddBackslashEx 函式 (pathcch.h)

將反斜杠新增至字串結尾,以建立路徑的正確語法。 如果來源路徑已經有尾端反斜杠,則不會新增反斜杠。

此函式與 PathCchAddBackslash 不同,因為它可以傳回字串新結尾的指標,並報告緩衝區中剩餘的未使用字元數目。

此函式與 PathAddBackslash 不同,因為它會接受具有 “\”、“\?” 和 “\?\UNC” 前置詞的路徑。

注意 此函式或 PathCchAddBackslash 應該用來取代 PathAddBackslash ,以避免緩衝區溢出的可能性。

語法

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

參數

[in, out] pszPath

路徑字串的指標。 當此函式成功傳回時,緩衝區會包含具有附加反斜杠的字串。 此值不應為 NULL

[in] cchPath

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

[out, optional] ppszEnd

值,當此函式成功傳回時,會在字串結尾接收終止 Null 字元的指標位址。

[out, optional] pcchRemaining

當此函式成功傳回時,值指標會設定為目的地緩衝區中未使用的字元數目,包括終止的 Null 字元。

傳回值

如果函式成功,此函式會傳回S_OK,S_FALSE路徑字串已以反斜杠結尾,否則傳回錯誤碼。

規格需求

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

另請參閱

PathCchAddBackslash