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
Library	Pathcch.lib