SHCreateShellItemArrayFromShellItem-Funktion (shobjidl_core.h)

Erstellt ein Array aus einem Element aus einem einzelnen Shellelement.

Syntax

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

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ückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein Zeiger auf ein IShellItemArray.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion erstellt ein Einelementarray aus einem einzelnen Element. Verwenden Sie SHCreateShellItemArray, um ein Array aus dem Inhalt eines Ordners zu erstellen.

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 (einschließlich Shobjidl.h)
DLL Shell32.dll