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 |