PathAllocCombine 函数 (pathcch.h)
将两个路径片段串联成一个路径。 此函数还规范化任何相对路径元素，替换路径元素，例如“.”和“..”。
此函数不同于 PathCchCombine 和 PathCchCombineEx ，因为它在堆上返回结果。 这意味着调用方不必声明返回的字符串的大小，减少了堆栈的使用。
此函数与 PathCombine 的不同之处在于，它接受带有“\”、“\？”和“\？\UNC”前缀的路径。
<
语法
WINPATHCCHAPI HRESULT PathAllocCombine(
[in] PCWSTR pszPathIn,
[in] PCWSTR pszMore,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
参数
[in] pszPathIn
指向第一个路径字符串的指针。
[in] pszMore
指向第二个路径字符串的指针。 如果此路径以单个反斜杠开头，则它仅与 pszPathIn 指向的路径的根组合在一起。 如果此路径完全限定，则直接将其复制到输出缓冲区，而不与其他路径组合。
[in] dwFlags
以下一个或多个标志：
| 值 |
含义 |
-
PATHCCH_NONE
- 0x0000000
|
不允许构造 \\？\ 路径 (即长路径) 长于 MAX_PATH 。
|
-
PATHCCH_ALLOW_LONG_PATHS
- 0x00000001
|
允许构造长于 MAX_PATH 的路径。
|
-
PATHCCH_FORCE_ENABLE_LONG_NAME_PROCESS
- 0x00000002
|
强制 API 将调用方视为已启用长路径，这与进程的长名称启用状态无关。 仅当指定 了PATHCCH_ALLOW_LONG_PATHS 时才可使用此选项，不能与 PATHCCH_FORCE_DISABLE_LONG_NAME_PROCESS 一起使用。
注意此值从 Windows 10 版本 1703 开始可用。
|
-
PATHCCH_FORCE_DISABLE_LONG_NAME_PROCESS
- 0x00000004
|
强制 API 将调用方视为已禁用的长路径，与进程的长名称启用状态无关。 仅当指定 PATHCCH_ALLOW_LONG_PATHS 时才可使用此选项，不能与 PATHCCH_FORCE_ENABLE_LONG_NAME_PROCESS 一起使用。
注意此值从 Windows 10 版本 1703 开始可用。
|
-
PATHCCH_DO_NOT_NORMALIZE_SEGMENTS
- 0x00000008
|
禁用路径段的规范化，包括删除尾随点和空格。 这样就可以访问 win32 路径规范化将阻止的路径。
注意此值从 Windows 10 版本 1703 开始可用。
|
-
PATHCCH_ENSURE_IS_EXTENDED_LENGTH_PATH
- 0x00000010
|
将输入路径转换为具有 \\？\ 前缀) 的扩展长度 DOS 设备路径窗体 (（如果尚未在该窗体中）。 这样就可以访问由于 Win32 规范化规则 (而无法寻址的路径，这些规则可以去除尾随点和空格) 和路径长度限制。 此选项意味着 PATHCCH_DO_NOT_NORMALIZE_SEGMENTS的行为相同。
注意此值从 Windows 10 版本 1703 开始可用。
|
-
PATHCCH_ENSURE_TRAILING_SLASH
- 0x00000020
|
组合或规范化路径时，请确保存在尾随反斜杠。
注意此值从 Windows 10 版本 1703 开始可用。
|
[out] ppszPathOut
指向缓冲区的指针的地址，当此函数成功返回时，该缓冲区接收组合的路径字符串。 当不再需要此资源时，调用方有责任通过调用 LocalFree 函数来释放此资源。 此值不能为 NULL。
返回值
如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
虽然 pszPathIn 或 pszMore 都可以 为 NULL，但它们不能同时为 NULL。
此函数支持以下备用路径形式：
- \\?\
- \\？\\Unc\
- \\？\Volume{guid}\
要求
| 要求 |
值 |
|
最低受支持的客户端 |
Windows 8 [桌面应用 |UWP 应用] |
|
最低受支持的服务器 |
Windows Server 2012 [桌面应用 |UWP 应用] |
|
目标平台 |
Windows |
|
标头 |
pathcch.h |
|
Library |
Pathcch.lib |
另请参阅
PathCchCombine
PathCchCombineEx