ITransferSource::RenameItem-Methode (shobjidl_core.h)

  • Artikel

Ändert den Namen eines Elements und gibt das IShellItem mit dem neuen Namen zurück.

Syntax

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Parameter

[in] psiSource

Typ: IShellItem*

Ein Zeiger auf das IShellItem-Objekt , das umbenannt werden soll.

[in] pszNewName

Typ: LPCWSTR

Ein Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den neuen Namen enthält.

[in] flags

Typ: TRANSFER_SOURCE_FLAGS

Flags, die den Dateivorgang steuern. Mindestens eine der TRANSFER_SOURCE_FLAGS Konstanten.

[out] ppsiNewDest

Typ: IShellItem**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das IShellItem-Objekt .

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Oder einen Fehlercode zurück.

Rückgabecode Beschreibung
COPYENGINE_S_YES
 Der Benutzer hat auf das Dialogfeld mit "Ja" geantwortet.
COPYENGINE_S_USER_RETRY
 Der Benutzer hat geantwortet, um die aktuelle Aktion erneut auszuführen.
COPYENGINE_S_USER_IGNORED
 Der Benutzer hat auf das Dialogfeld mit "Nein" geantwortet.
COPYENGINE_S_MERGE
 Der Benutzer hat auf Mergeordner geantwortet.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 Der Benutzer hat geantwortet, um die Datei mit dem neuen Namen zu wiederholen.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 Untergeordnete Elemente sollten nicht verarbeitet werden.
COPYENGINE_S_PENDING
 Der Fehler wurde in die Warteschlange eingereiht und wird später angezeigt.
COPYENGINE_E_USER_CANCELLED
 Der Benutzer hat die aktuelle Aktion abgebrochen.
COPYENGINE_E_REQUIRES_ELEVATION
 Für den Vorgang sind erhöhte Berechtigungen erforderlich.

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)