IFileOperation::SetProperties-Methode (shobjidl_core.h)

Artikel
03/02/2024

Deklariert einen Satz von Eigenschaften und Werten, die für ein Element oder Elemente festgelegt werden sollen.

Syntax

HRESULT SetProperties(
  [in] IPropertyChangeArray *pproparray
);

Parameter

[in] pproparray

Typ: IPropertyChangeArray*

Zeiger auf ein IPropertyChangeArray-Objekt, das auf eine Auflistung von IPropertyChange-Objekten zugreift, die die festzulegenden Eigenschaften und ihre neuen Werte angeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode legt die neuen Eigenschaftswerte nicht fest, sondern deklariert sie lediglich. Um Eigenschaftswerte für ein Element oder eine Gruppe von Elementen festzulegen, müssen Sie mindestens die hier beschriebene Reihenfolge von Aufrufen ausführen:

Rufen Sie IFileOperation::SetProperties auf, um die festzulegenden eigenschaften und ihre neuen Werte zu deklarieren.
Rufen Sie IFileOperation::ApplyPropertiesToItem oder IFileOperation::ApplyPropertiesToItems auf, um das Element oder die Elemente zu deklarieren, deren Eigenschaften festgelegt werden sollen.
Rufen Sie IFileOperation::P erformOperations auf , um die Eigenschaften auf das Element oder die Elemente anzuwenden.

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 (shobjidl.h einschließen)

Share via