PathMakeUniqueName 函数 (shlobj_core.h)

从模板创建唯一的路径名称。

语法

BOOL PathMakeUniqueName(
  [out]          PWSTR  pszUniqueName,
                 UINT   cchMax,
  [in]           PCWSTR pszTemplate,
  [in, optional] PCWSTR pszLongPlate,
  [in, optional] PCWSTR pszDir
);

参数

[out] pszUniqueName

类型： PWSTR

接收包含唯一路径名称的以 null 结尾的 Unicode 字符串的缓冲区。 长度至少应为 MAX_PATH 个字符。

cchMax

类型： UINT

pszUniqueName 指向的缓冲区中的字符数。

[in] pszTemplate

类型： PCWSTR

一个以 null 结尾的 Unicode 字符串，其中包含用于构造唯一名称的模板。 此模板用于要求文件名为 8.3 格式的驱动器。 此字符串的长度应不超过 MAX_PATH 个字符，包括终止 null 字符。

[in, optional] pszLongPlate

类型： PCWSTR

一个以 null 结尾的 Unicode 字符串，其中包含用于构造唯一名称的模板。 此模板用于支持长文件名的驱动器。 此字符串的长度应不超过 MAX_PATH 个字符，包括终止 null 字符。

[in, optional] pszDir

类型： PCWSTR

一个以 null 结尾的字符串，其中包含新文件所在的目录。 此字符串的长度应不超过 MAX_PATH 个字符，包括终止 null 字符。

返回值

类型： BOOL

如果成功，则返回 TRUE ;否则为 FALSE。

注解

对于需要 8.3 格式的驱动器，此函数基于 pszTemplate 指定的模板生成新的唯一文件名，对于支持长文件名的驱动器， 生成 pszLongPlate 。 例如，如果为 pszLongPlate 指定“我的新文件名”， PathMakeUniqueName 将返回名称，例如“我的新文件名 (1) ”、“我的新文件名 (2) ”等。

要求

最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h)
Library	Shell32.lib
DLL	Shell32.dll (5.0 或更高版本)