IFolderView2::SetViewProperty method

[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,
  [inconst PROPVARIANT     *ppropvar
);

Parameters

pidl [in]

Type: PCUITEMID_CHILD

A PIDL that identifies the item.

propkey [in]

Type: REFPROPERTYKEY

The PROPERTYKEY which is to be stored.

ppropvar [in]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IFolderView2
Property Lists
Property Description Schema

 

 

Show: