Метод 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 , чтобы применить свойства к элементам.

Требования

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

IFileOperation

IFileOperation::ApplyPropertiesToItem