IFolderView2::SetViewProperty method (shobjidl_core.h)

[This method is still implemented, but should be considered deprecated as of Windows 7. It might not be implemented in future versions of Windows. It cannot be used with items in search results or library views, so consider using the item's existing properties or, if applicable, emitting properties from your namespace or property handler. See Developing Property Handlers for Windows Search for more information.]

Caches a property for an item in the view's property cache.

Syntax

DEPRECATED_HRESULT SetViewProperty(
  [in] PCUITEMID_CHILD pidl,
  [in] REFPROPERTYKEY  propkey,
  [in] REFPROPVARIANT  propvar
);

Parameters

[in] pidl

Type: PCUITEMID_CHILD

A PIDL that identifies the item.

[in] propkey

Type: REFPROPERTYKEY

The PROPERTYKEY which is to be stored.

[in] propvar

Type: const PROPVARIANT*

A pointer to a PROPVARIANT structure in which the PROPERTYKEY is stored.

Return value

Type: DEPRECATED_HRESULT

Returns S_OK if successful, or an error value otherwise.

Remarks

The property is displayed in the view, but not written to the underlying item.

Requirements

See also

IFolderView2

Property Description Schema

Property Lists