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

另请参阅

PathCchAddBackslash