ITransferSource::OpenItem-Methode (shobjidl_core.h)

Artikel
03/04/2024

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

Share via