SHCreateShellItemArray 函数 (shobjidl_core.h)

创建 Shell 项数组对象。

语法

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 错误代码。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)
DLL	Shell32.dll