PathCchCombine 函数 (pathcch.h)

  • 项目

将两个路径片段合并到一个路径中。 此函数还规范化任何相对路径元素，删除“.”和“..”元素以简化最终路径。

此函数与 PathCchCombineEx 的不同之处在于，只能使用长度MAX_PATH的最终路径。

此函数与 PathAllocCombine 的不同之处在于，调用方必须声明返回的字符串的大小，该字符串存储在堆栈中。

此函数与 PathCombine 的不同之处在于，它接受带有“\”、“\？”和“\？\UNC”前缀的路径。

注意 应使用此函数 PathCchCombineEx 或 PathAllocCombine 代替 PathCombine ，以防止缓冲区溢出的可能性。

语法

WINPATHCCHAPI HRESULT PathCchCombine(
  [out]          PWSTR  pszPathOut,
  [in]           size_t cchPathOut,
  [in, optional] PCWSTR pszPathIn,
  [in, optional] PCWSTR pszMore
);

参数

[out] pszPathOut

指向缓冲区的指针，当此函数成功返回时，该缓冲区接收组合的路径字符串。 此参数可以指向 与 pszPathIn 或 pszMore 相同的缓冲区。

[in] cchPathOut

pszPathOut 指向的缓冲区的大小（以字符为单位）。

[in, optional] pszPathIn

指向第一个路径字符串的指针。 此值可以为 NULL。

[in, optional] pszMore

指向第二个路径字符串的指针。 如果此路径以单个反斜杠开头，则它仅与 pszPathIn 指向的路径的根组合在一起。 如果此路径完全限定，则直接将其复制到输出缓冲区，而不与其他路径组合。 此值可以为 NULL。

返回值

此函数返回 HRESULT 代码，包括以下内容。

返回代码 说明
S_OK
 函数成功。 请注意，这还包括空扩展的情况，例如后跟没有字符的句点。 在这种情况下，原始字符串将原样返回。
E_INVALIDARG
 此值可能由多种因素引起，例如 pszPathOut 参数设置为 NULL，或 cchPathOut 值设置为 0 或大于 PATHCCH_MAX_CCH 的值。
E_OUTOFMEMORY
 函数无法分配足够的内存来执行操作。
PATHCCH_E_FILENAME_TOO_LONG
 一个或两个原始路径的大小超出了 PATHCCH_MAX_CCH。

注解

如果 pszPathIn 和 pszMore 均为 NULL 或指向空字符串，则会将单个反斜杠复制到 pszPathOut 指向的缓冲区。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 pathcch.h
Library Pathcch.lib

另请参阅

PathCchCanonicalize

PathCchCanonicalizeEx

PathCchCombineEx