SHCreateShellItemArray function
Applies to: desktop apps only
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 |
|---|---|
|
Minimum supported server | Windows Server 2008 |
|
Header |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 3/7/2012
