SHCreateShellItemArrayFromShellItem-Funktion (shobjidl_core.h)

Erstellt ein Array eines Elements aus einem einzelnen Shell-Element.

Syntax

SHSTDAPI SHCreateShellItemArrayFromShellItem(
  [in]  IShellItem *psi,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Die Parameter

[in] psi

Typ: IShellItem*

Zeiger auf das IShellItem-Objekt , das das Element darstellt.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_IShellItemArray.

[out] ppv

Typ: void**

Wenn diese Methode zurückgegeben wird, enthält sie den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein Zeiger auf ein 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 erstellt ein Ein-Element-Array aus einem einzelnen Element. Verwenden Sie SHCreateShellItemArray, um ein Array aus dem Inhalt eines Ordners zu erstellen.

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