SHCreateShellItemArray-Funktion (shobjidl_core.h)

Erstellt ein Shell-Elementarrayobjekt.

Syntax

SHSTDAPI SHCreateShellItemArray(
  [in]  PCIDLIST_ABSOLUTE     pidlParent,
  [in]  IShellFolder          *psf,
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY ppidl,
  [out] IShellItemArray       **ppsiItemArray
);

Die Parameter

[in] pidlParent

Typ: PCIDLIST_ABSOLUTE

Die ID-Liste des übergeordneten Ordners der in ppidl angegebenen Elemente. Wenn psf angegeben ist, kann dieser Parameter NULL sein. Wenn diese pidlParent nicht angegeben ist, wird sie aus dem psf-Parameter mithilfe von IPersistFolder2 berechnet.

[in] psf

Typ: IShellFolder*

Das Shell-Datenquellenobjekt, das das übergeordnete Element der untergeordneten Elemente ist, die in ppidl angegeben sind. Wenn pidlParent angegeben ist, kann dieser Parameter NULL sein.

[in] cidl

Typ: UINT

Die Anzahl der Elemente im Array, das durch ppidl angegeben wird.

[in] ppidl

Typ: PCUITEMID_CHILD_ARRAY

Die Liste der untergeordneten Element-IDs, für die das Array erstellt wird. Dieser Wert kann NULL-sein.

[out] ppsiItemArray

Typ: IShellItemArray**

Wenn diese Funktion zurückgegeben wird, enthält sie die Adresse eines IShellItemArray-Schnittstellenzeigers .

Rückgabewert

Typ: HRESULT-

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

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