SHCreateShellItemArray
TOC
Collapse the table of content
Expand the table of content

SHCreateShellItemArray function

Creates a Shell item array object.

Syntax


HRESULT SHCreateShellItemArray(
  _In_  PCIDLIST_ABSOLUTE     pidlParent,
  _In_  IShellFolder          *psf,
  _In_  UINT                  cidl,
  _In_  PCUITEMID_CHILD_ARRAY ppidl,
  _Out_ IShellItemArray       **ppsiItemArray
);

Parameters

pidlParent [in]

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.

psf [in]

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.

cidl [in]

Type: UINT

The number of elements in the array specified by ppidl.

ppidl [in]

Type: PCUITEMID_CHILD_ARRAY

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

ppsiItemArray [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

DLL

Shell32.dll

 

 

Show:
© 2016 Microsoft