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:
- Call IFileOperation::SetProperties to declare the specific properties to be set and their new values.
- Call IFileOperation::ApplyPropertiesToItem or IFileOperation::ApplyPropertiesToItems to declare the item or items whose properties are to be set.
- 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) |