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

Метод IFileOperation::RenameItems (shobjidl_core.h)

  • Статья

Объявляет набор элементов, которым должно быть присвоено новое отображаемое имя. Всем элементам присваиваются одинаковые имена.

Синтаксис

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

Параметры

[in] pUnkItems

Тип: IUnknown*

Указатель на IUnknown объекта IShellItemArray, IDataObject или IEnumShellItems , который представляет группу переименовываемых элементов. Вы также можете указать объект IPersistIDList для представления одного элемента, эффективно выполняя ту же функцию, что и IFileOperation::RenameItem.

[in] pszNewName

Тип: LPCWSTR

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если несколько элементов в коллекции pUnkItems находятся в одной папке, переименованные файлы добавляются с числом в скобках, чтобы различать их, например newfile(1).txt, newfile(2).txt и newfile(3).txt.

Этот метод не переименовывает элементы, а просто объявляет элементы для переименования. Чтобы переименовать группу объектов, необходимо выполнить по крайней мере последовательность вызовов, описанную здесь:

  1. Вызовите метод IFileOperation::RenameItems , чтобы объявить исходные файлы или папки и новое имя.
  2. Вызовите метод IFileOperation::P erformOperations , чтобы начать операцию переименования.

Требования

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

См. также раздел

IFileOperation

IFileOperation::RenameItem