PathYetAnotherMakeUniqueName 函数 (shlobj_core.h)
基于现有文件名创建唯一文件名。
语法
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
参数
[out] pszUniqueName
类型： PWSTR
一个字符串缓冲区，它接收以 null 结尾的 Unicode 字符串，该字符串包含唯一文件名的完全限定路径。 此缓冲区应至少MAX_PATH个字符，以避免导致缓冲区溢出。
[in] pszPath
类型： PCWSTR
一个以 null 结尾的 Unicode 字符串，其中包含将包含新文件的文件夹的完全限定路径。 如果 pszShort 设置为 NULL，则此字符串必须包含完整的目标路径，以新文件名所基于的长文件名结尾。
[in, optional] pszShort
类型： PCWSTR
一个以 null 结尾的 Unicode 字符串，其中包含唯一名称将基于的短文件名。 将此值设置为 NULL 以基于长文件名创建名称。
[in, optional] pszFileSpec
类型： PCWSTR
一个以 null 结尾的 Unicode 字符串，其中包含唯一名称所基于的长文件名。
返回值
类型： BOOL
如果成功创建唯一名称，则返回 TRUE ;否则 为 FALSE。
注解
如果生成的路径超过 MAX_PATH 个字符，此函数可能会在 PathYetAnotherMakeUniqueName 中返回截断的字符串。 在这种情况下，函数返回 FALSE。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | shlobj_core.h (包括 Shlobj.h) |
| Library | Shell32.lib |
| DLL | Shell32.dll (5.0 或更高版本) |
| API 集 | Windows 10版本 10.0.10240 中引入的 ext-ms-win-shell-shell32-l1-2-1 () |