IFileOperation::ApplyPropertiesToItem method (shobjidl_core.h)

Declares a single item whose property values are to be set.

Syntax

HRESULT ApplyPropertiesToItem(
  [in] IShellItem *psiItem
);

Parameters

[in] psiItem

Type: IShellItem*

Pointer to the item to receive the new property 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 apply the properties to the item, it merely declares the item. To set property values on an item, 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 to declare the item whose properties are to be set.
  3. Call IFileOperation::PerformOperations to apply the properties to the item.

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)

See also

IFileOperation

IFileOperation::ApplyPropertiesToItems