Функция PathYetAnotherMakeUniqueName (shlobj_core.h)
Создает уникальное имя файла на основе существующего имени файла.
Синтаксис
BOOL PathYetAnotherMakeUniqueName(
[out] PWSTR pszUniqueName,
[in] PCWSTR pszPath,
[in, optional] PCWSTR pszShort,
[in, optional] PCWSTR pszFileSpec
);
Параметры
[out] pszUniqueName
Тип: PWSTR
Строковый буфер, получающий строку Юникода, завершающуюся null, которая содержит полный путь к уникальному имени файла. Этот буфер должен содержать не менее MAX_PATH символов, чтобы избежать переполнения буфера.
[in] pszPath
Тип: PCWSTR
Строка Юникода, заканчивающаяся нулевым значением, которая содержит полный путь к папке, которая будет содержать новый файл. Если для pszShort задано значение NULL, эта строка должна содержать полный конечный путь, заканчивающийся длинным именем файла, на котором будет основываться новое имя файла.
[in, optional] pszShort
Тип: PCWSTR
Строка Юникода с символом NULL, содержащая короткое имя файла, на котором будет основано уникальное имя. Присвойте этому значению значение NULL , чтобы создать имя на основе длинного имени файла.
[in, optional] pszFileSpec
Тип: PCWSTR
Строка Юникода с пустым завершением, содержащая длинное имя файла, на котором будет основано уникальное имя.
Возвращаемое значение
Тип: BOOL
Возвращает значение TRUE , если уникальное имя было успешно создано; в противном случае — FALSE.
Комментарии
Если созданный путь превышает MAX_PATH символов, эта функция может возвращать усеченную строку в PathYetAnotherMakeUniqueName. В этом случае функция возвращает значение FALSE.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj_core.h (включая Shlobj.h) |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 5.0 или более поздняя) |
| Набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |