IFileOperation::SetProperties method (shobjidl_core.h)

Declares a set of properties and values to be set on an item or items.

Syntax

HRESULT SetProperties(
  [in] IPropertyChangeArray *pproparray
);

Parameters

[in] pproparray

Type: IPropertyChangeArray*

Pointer to an IPropertyChangeArray, which accesses a collection of IPropertyChange objects that specify the properties to be set and their new values.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method does not set the new property values, it merely declares them. To set property values on an item or a group of items, you must make at least the sequence of calls detailed here:

  1. Call IFileOperation::SetProperties to declare the specific properties to be set and their new values.
  2. Call IFileOperation::ApplyPropertiesToItem or IFileOperation::ApplyPropertiesToItems to declare the item or items whose properties are to be set.
  3. Call IFileOperation::PerformOperations to apply the properties to the item or items.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)