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 ()

另请参阅

PathMakeUniqueName