IFolderView2::SetViewProperty method (shobjidl_core.h)

Article
02/22/2024

[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

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)