SHGetTemporaryPropertyForItem function (shobjidl_core.h)

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(
  [in]  IShellItem     *psi,
        REFPROPERTYKEY propkey,
  [out] PROPVARIANT    *ppropvar
);

Parameters

[in] psi

Type: IShellItem*

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

propkey

Type: REFPROPERTYKEY

The property key.

[out] 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

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)
DLL Shell32.dll
API set ext-ms-win-shell-shell32-l1-2-2 (introduced in Windows 10, version 10.0.14393)