IFileOperation::RenameItems-Methode (shobjidl_core.h)
Deklariert eine Gruppe von Elementen, denen ein neuer Anzeigename zugewiesen werden soll. Alle Elemente erhalten den gleichen Namen.
Syntax
HRESULT RenameItems(
[in] IUnknown *pUnkItems,
[in] LPCWSTR pszNewName
);
Parameter
[in] pUnkItems
Typ: IUnknown*
Zeiger auf das IUnknown des IShellItemArray-, IDataObject- oder IEnumShellItems-Objekts , das die Gruppe der umzubenennten Elemente darstellt. Sie können auch auf ein IPersistIDList-Objekt verweisen, um ein einzelnes Element darzustellen, wodurch die gleiche Funktion wie IFileOperation::RenameItem erreicht wird.
[in] pszNewName
Typ: LPCWSTR
Zeiger auf den neuen Anzeigenamen der Elemente. Hierbei handelt es sich um eine Unicode-Zeichenfolge, die null beendet wird.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn sich mehr als eines der Elemente in der Auflistung bei pUnkItems im selben Ordner befindet, werden die umbenannten Dateien mit einer Zahl in Klammern angefügt, um sie zu unterscheiden, für instance newfile(1).txt, newfile(2).txt und newfile(3).txt.
Diese Methode benennt die Elemente nicht um, sondern deklariert lediglich die umzubenennten Elemente. Um eine Gruppe von Objekten umzubenennen, müssen Sie mindestens die hier beschriebene Reihenfolge von Aufrufen ausführen:
- Rufen Sie IFileOperation::RenameItems auf, um die Quelldateien oder -ordner und den neuen Namen zu deklarieren.
- Rufen Sie IFileOperation::P erformOperations auf, um den Umbenennungsvorgang zu starten.
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) |