PathCchRemoveBackslashEx 函式 (pathcch.h)

從路徑字串結尾移除尾端反斜杠。

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

此函式與 PathRemoveBackslash 不同，因為它接受具有 “\”、“\？” 和 “\？\UNC” 前置詞的路徑。

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

語法

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

參數

[in, out] pszPath

路徑字串的指標。 當此函式成功傳回時，字串會包含已移除任何尾端反斜杠的路徑。 如果找不到尾端反斜杠，則字串不會變更。

[in] cchPath

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

[out, optional] ppszEnd

值，當此函式成功傳回時，會接收新字串結尾的指標位址。 如果字串是 「C：“ 之類的根路徑，則指標會指向反斜杠;否則，指標會指向字串的終止 Null 字元。

[out, optional] pcchRemaining

值的指標，當此函式成功傳回時，會接收目的地緩衝區中未使用的字元數目，包括終止的 Null 字元。 如果字串是 「C：“ 之類的根路徑，此計數會包含該字串中的反斜杠。

傳回值

如果函式成功，則此函式會傳回S_OK，S_FALSE字串為根路徑，或找不到反斜杠，否則傳回錯誤碼。

備註

此函式不會從根路徑字串中移除反斜杠，例如 “C：”。

規格需求

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