SHCreateShellItemArray function (shobjidl_core.h)

Creates a Shell item array object.

Syntax

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

Parameters

[in] pidlParent

Type: PCIDLIST_ABSOLUTE

The ID list of the parent folder of the items specified in ppidl. If psf is specified, this parameter can be NULL. If this pidlParent is not specified, it is computed from the psf parameter using IPersistFolder2.

[in] psf

Type: IShellFolder*

The Shell data source object that is the parent of the child items specified in ppidl. If pidlParent is specified, this parameter can be NULL.

[in] cidl

Type: UINT

The number of elements in the array specified by ppidl.

[in] ppidl

Type: PCUITEMID_CHILD_ARRAY

The list of child item IDs for which the array is being created. This value can be NULL.

[out] ppsiItemArray

Type: IShellItemArray**

When this function returns, contains the address of an IShellItemArray interface pointer.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements