SHSetTemporaryPropertyForItem-Funktion (shobjidl_core.h)

Artikel
03/02/2024

Legt eine temporäre Eigenschaft für das angegebene Element fest. Eine temporäre Eigenschaft wird in einem Lese-/Schreibspeicher aufbewahrt, der Eigenschaften nur für die Lebensdauer des IShellItem-Objekts enthält, anstatt sie zurück in das Element zu schreiben.

Syntax

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

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf das Element, für das die temporäre Eigenschaft festgelegt werden soll.

[in] propkey

Typ: REFPROPERTYKEY

Verweis auf den PROPERTYKEY , der die temporäre Eigenschaft identifiziert, die festgelegt wird.

[in] propvar

Typ: REFPROPVARIANT

Verweis auf eine PROPVARIANT-Eigenschaft , die den Wert der temporären Eigenschaft enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein temporärer Wert kann nur mit SHGetTemporaryPropertyForItem oder durch Übergeben von GPS_TEMPORARY an IShellItem2::GetPropertyStore gelesen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll

Freigeben über