SHGetTemporaryPropertyForItem function

Retrieves the temporary property for the given item. A temporary property is a read/write store that holds properties only for the lifetime of the IShellItem object, rather than being persisted back into the item.

Syntax

SHSTDAPI SHGetTemporaryPropertyForItem(
  IShellItem     *psi,
  REFPROPERTYKEY propkey,
  PROPVARIANT    *ppropvar
);

Parameters

psi

Type: IShellItem*

A pointer to the item for which the temporary property is to be retrieved.

propkey

Type: REFPROPERTYKEY

The property key.

ppropvar

Type: PROPVARIANT*

A pointer to the temporary property for the item.

Return Value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll