Funzione SHSetTemporaryPropertyForItem (shobjidl_core.h)

Articolo
03/02/2024

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

Condividi tramite