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

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

  • Статья

Изменяет имя элемента, возвращая 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)