IFileOperation::ApplyPropertiesToItems method (shobjidl_core.h)
Declares a set of items for which to apply a common set of property values.
Syntax
HRESULT ApplyPropertiesToItems(
[in] IUnknown *punkItems
);
Parameters
[in] punkItems
Type: IUnknown*
Pointer to the IUnknown of the IShellItemArray, IDataObject, or IEnumShellItems object which represents the group of items. You can also point to an IPersistIDList object to represent a single item, effectively accomplishing the same function as IFileOperation::ApplyPropertiesToItem.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This method does not apply the properties to the items, it merely declares the items. To set property values on 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::ApplyPropertiesToItems to declare the items whose property values are to be set.
- Call IFileOperation::PerformOperations to apply the properties to the 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) |