ITransferSource::RecycleItem-Methode (shobjidl_core.h)

  • Artikel

Recyceln Sie das Element an den angegebenen Wiederverwendungsort, und geben Sie das Element an seinem neuen Speicherort zurück.

Syntax

HRESULT RecycleItem(
  [in]  IShellItem            *psiSource,
  [in]  IShellItem            *psiParentDest,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

Parameter

[in] psiSource

Typ: IShellItem*

Ein Zeiger auf das zu recycelnde IShellItem .

[in] psiParentDest

Typ: IShellItem*

Ein Zeiger auf das IShellItem des Wiederverwendungsspeicherorts (das neue übergeordnete Element des Elements).

[in] flags

Typ: TRANSFER_SOURCE_FLAGS

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

[out] ppsiNewDest

Typ: IShellItem**

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

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_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)