SHCreateShellItemArrayFromDataObject-Funktion (shobjidl_core.h)

Erstellt ein Shell-Elementarrayobjekt aus einem Datenobjekt.

Syntax

SHSTDAPI SHCreateShellItemArrayFromDataObject(
  [in]  IDataObject *pdo,
  [in]  REFIID      riid,
  [out] void        **ppv
);

Die Parameter

[in] pdo

Typ: IDataObject*

Ein Zeiger auf die IDataObject-Schnittstelle .

[in] riid

Typ: REFIID

Ein Verweis auf die gewünschte Schnittstellen-ID.

[out] ppv

Typ: void**

Wenn diese Methode zurückgegeben wird, enthält sie den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellItemArray.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese Funktion ist nützlich für Shell-Erweiterungen, die IShellExtInit implementieren und ein Datenobjekt an die IShellExtInit::Initialize-Methode übergeben werden; Beispiel: Kontextmenühandler.

Mit dieser API können Sie das Datenobjekt in ein Shellelement konvertieren, das der Handler nutzen kann. Es wird empfohlen, dass Handler ein Shellelementarray anstelle von Zwischenablageformaten wie CF_HDROP und CFSTR_SHELLIDLIST (auch als HIDA bezeichnet) verwenden, da es zu einfacherem Code führt und einige Leistungsverbesserungen zulässt.

Das resultierende Shellelementarray enthält einen Verweis auf das Quelldatenobjekt. Daher muss dieses Datenobjekt für die Lebensdauer des Shellelementarrays gültig bleiben. Insbesondere sind die an IDropTarget-Methoden übergebenen Datenobjekte nach Abschluss des Dropvorgangs nicht mehr gültig.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	shobjidl_core.h (include Shobjidl.h)
Library	OneCore.Lib
DLL	Shell32.dll
API-Satz	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)