ITransferSource::OpenItem-Methode (shobjidl_core.h)

  • Artikel

Öffnet das Element zum Kopieren. Gibt ein Objekt zurück, das für Ressourcen (IShellItemResources) aufgezählt werden kann.

Syntax

HRESULT OpenItem(
  [in]  IShellItem            *psi,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] REFIID                riid,
  [out] void                  **ppv
);

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf das zu öffnende IShellItem .

[in] flags

Typ: TRANSFER_SOURCE_FLAGS

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

[out] riid

Typ: REFIID

Ein Verweis auf die IID (die Schnittstellen-ID oder GUID) der Schnittstelle, die in ppv zurückgegeben werden soll. Dies sollte ein IShellItemResources oder eine von IShellItemResources abgeleitete Schnittstelle sein.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die durch riid angegebene Schnittstelle.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder einen der folgenden spezifischen Shellcodes oder einen Systemfehlercode 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)