Метод ITransferSource::RenameItem (shobjidl_core.h)

Статья
08/26/2023

Изменяет имя элемента, возвращая IShellItem с новым именем.

Синтаксис

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Параметры

[in] psiSource

Тип: IShellItem*

Указатель на объект IShellItem для переименования.

[in] pszNewName

Тип: LPCWSTR

Указатель на строку Юникода, завершающуюся null, которая содержит новое имя.

[in] flags

Тип: TRANSFER_SOURCE_FLAGS

Флаги, управляющие операцией с файлом. Одна или несколько констант TRANSFER_SOURCE_FLAGS .

[out] ppsiNewDest

Тип: IShellItem**

При возврате этим методом содержит адрес указателя на объект IShellItem .

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

Тип: HRESULT

Возвращает один из следующих значений или код ошибки.

Код возврата	Описание
COPYENGINE_S_YES	Пользователь ответил "Да" на диалоговое окно.
COPYENGINE_S_USER_RETRY	Пользователь ответил на повторную попытку текущего действия.
COPYENGINE_S_USER_IGNORED	Пользователь ответил "Нет" на диалоговое окно.
COPYENGINE_S_MERGE	Пользователь ответил на слияние папок.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME	Пользователь ответил на повторную попытку файла с новым именем.
COPYENGINE_S_DONT_PROCESS_CHILDREN	Дочерние элементы не должны обрабатываться.
COPYENGINE_S_PENDING	Ошибка была поставлена в очередь и отобразится позже.
COPYENGINE_E_USER_CANCELLED	Пользователь отменил текущее действие.
COPYENGINE_E_REQUIRES_ELEVATION	Для операции требуются повышенные привилегии.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

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