IFileOperation::ApplyPropertiesToItems-Methode (shobjidl_core.h)
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:
- Rufen Sie IFileOperation::SetProperties auf, um die festzulegenden spezifischen Eigenschaften und ihre neuen Werte zu deklarieren.
- Rufen Sie IFileOperation::ApplyPropertiesToItems auf, um die Elemente zu deklarieren, deren Eigenschaftswerte festgelegt werden sollen.
- 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) |