IFileOperation::SetProperties-Methode (shobjidl_core.h)

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:

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

Anforderungen