创建 Shell 项数组对象。
Syntax
SHSTDAPI SHCreateShellItemArray(
[in] PCIDLIST_ABSOLUTE pidlParent,
[in] IShellFolder *psf,
[in] UINT cidl,
[in] PCUITEMID_CHILD_ARRAY ppidl,
[out] IShellItemArray **ppsiItemArray
);
参数
[in] pidlParent
类型： PCIDLIST_ABSOLUTE
ppidl 中指定的项目的父文件夹的 ID 列表。 如果指定 psf ，此参数可以为 NULL。 如果未指定此 pidlParent，则它使用 IPersistFolder2 从 psf 参数计算。
[in] psf
类型： IShellFolder*
Shell 数据源对象，该对象是 ppidl 中指定的子项的父项。 如果指定 pidlParent ，此参数可以为 NULL。
[in] cidl
类型： UINT
由 ppidl 指定的数组中的元素数。
[in] ppidl
类型： PCUITEMID_CHILD_ARRAY
要为其创建数组的子项 ID 的列表。 此值可以 NULL。
[out] ppsiItemArray
类型： IShellItemArray**
当此函数返回时，包含 IShellItemArray 接口指针的地址。
返回值
类型：HRESULT
如果此函数成功，它将返回 S_OK。 否则，它将返回 HRESULT 错误代码。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | shobjidl_core.h （包括 Shobjidl.h） |
| Library | OneCore.Lib |
| DLL | Shell32.dll |