IFileOperation::ApplyPropertiesToItems-Methode (shobjidl_core.h)

  • Artikel

Deklariert eine Gruppe von Elementen, für die ein allgemeiner Satz von Eigenschaftenwerten angewendet werden soll.

Syntax

HRESULT ApplyPropertiesToItems(
  [in] IUnknown *punkItems
);

Parameter

[in] punkItems

Typ: IUnknown*

Zeiger auf das IUnknown des IShellItemArray-, IDataObject- oder IEnumShellItems-Objekts , das die Gruppe von Elementen darstellt. Sie können auch auf ein IPersistIDList-Objekt zeigen, um ein einzelnes Element darzustellen, wodurch die gleiche Funktion wie IFileOperation::ApplyPropertiesToItem ausgeführt wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode wendet die Eigenschaften nicht auf die Elemente an, sondern deklariert lediglich die Elemente. Um Eigenschaftswerte für eine Gruppe von Elementen festzulegen, müssen Sie mindestens die hier beschriebene Reihenfolge der Aufrufe vornehmen:

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

Anforderungen

   
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)

Weitere Informationen

IFileOperation

IFileOperation::ApplyPropertiesToItem