Funzione SHSetTemporaryPropertyForItem (shobjidl_core.h)

Imposta una proprietà temporanea per l'elemento specificato. Una proprietà temporanea viene mantenuta in un archivio di lettura/scrittura che contiene proprietà solo per la durata dell'oggetto IShellItem , anziché scriverle nuovamente nell'elemento.

Sintassi

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

Parametri

[in] psi

Tipo: IShellItem*

Puntatore all'elemento in cui deve essere impostata la proprietà temporanea.

[in] propkey

Tipo: REFPROPERTYKEY

Riferimento a PROPERTYKEY che identifica la proprietà temporanea impostata.

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a un PROPVARIANT che contiene il valore della proprietà temporanea.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un valore temporaneo può essere letto solo con SHGetTemporaryPropertyForItem o passando GPS_TEMPORARY a IShellItem2::GetPropertyStore.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
Libreria Shell32.lib
DLL Shell32.dll