Поделиться через

Функция 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

Буфер, получающий строку Юникода, завершающуюся нулевым значением, которая содержит уникальное имя пути. Длина должна быть не менее MAX_PATH символов.

cchMax

Тип: UINT

Количество символов в буфере, на которое указывает pszUniqueName.

[in] pszTemplate

Тип: PCWSTR

Строка Юникода, завершающаяся нулевым значением, которая содержит шаблон, используемый для создания уникального имени. Этот шаблон используется для дисков, для которых требуются имена файлов в формате 8.3. Длина этой строки не должна превышать MAX_PATH символов, включая завершающий символ NULL.

[in, optional] pszLongPlate

Тип: PCWSTR

Строка Юникода, завершающаяся нулевым значением, которая содержит шаблон, используемый для создания уникального имени. Этот шаблон используется для дисков, поддерживающих длинные имена файлов. Длина этой строки не должна превышать MAX_PATH символов, включая завершающий символ NULL.

[in, optional] pszDir

Тип: PCWSTR

Строка, завершающаяся нулевым значением, содержащая каталог, в котором находится новый файл. Длина этой строки не должна превышать MAX_PATH символов, включая завершающий символ NULL.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE при успешном выполнении; в противном случае — FALSE.

Комментарии

Эта функция создает новое уникальное имя файла на основе шаблонов, указанных в pszTemplate, для дисков, для которых требуется формат 8.3, и pszLongPlate для дисков, поддерживающих длинные имена файлов. Например, если указать "My New Filename" для pszLongPlate, PathMakeUniqueName возвращает такие имена, как "My New Filename (1)", "My New Filename (2)" и т. д.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 5.0 или более поздняя)