SHCreateShellItemArray-Funktion (shobjidl_core.h)

  • Artikel

Erstellt ein Shellelementarrayobjekt.

Syntax

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

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-Instanz nicht angegeben wird, wird sie mithilfe von IPersistFolder2 aus dem psf-Parameter 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 in dem von ppidl angegebenen Array.

[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ückgibt, enthält die Adresse eines IShellItemArray-Schnittstellenzeigers .

Rückgabewert

Typ: HRESULT

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

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