IFileOperation::RenameItems-Methode (shobjidl_core.h)

  • Artikel

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:

  1. Rufen Sie IFileOperation::RenameItems auf, um die Quelldateien oder -ordner und den neuen Namen zu deklarieren.
  2. 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)

Weitere Informationen

IFileOperation

IFileOperation::RenameItem