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


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

Объявляет набор элементов, к которым применяется общий набор значений свойств.

Синтаксис

HRESULT ApplyPropertiesToItems(
  [in] IUnknown *punkItems
);

Параметры

[in] punkItems

Тип: IUnknown*

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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

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

IFileOperation

IFileOperation::ApplyPropertiesToItem