SHSetTemporaryPropertyForItem 函数 (shobjidl_core.h)

设置指定项的临时属性。 临时属性保留在读/写存储中,该存储区仅在 IShellItem 对象的生存期内保留属性,而不是将它们写回到项中。

语法

SHSTDAPI SHSetTemporaryPropertyForItem(
  [in] IShellItem     *psi,
  [in] REFPROPERTYKEY propkey,
  [in] REFPROPVARIANT propvar
);

参数

[in] psi

类型: IShellItem*

指向要对其设置临时属性的项的指针。

[in] propkey

类型: REFPROPERTYKEY

对标识正在设置的临时属性的 PROPERTYKEY 的引用。

[in] propvar

类型: REFPROPVARIANT

对包含临时属性值的 PROPVARIANT 的引用。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

临时值只能使用 SHGetTemporaryPropertyForItem 或通过将GPS_TEMPORARY传递给 IShellItem2::GetPropertyStore 来读取。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll