SHCreateShellItemArrayFromShellItem 函数 (shobjidl_core.h)

从单个 Shell 项创建包含一个元素的数组。

语法

SHSTDAPI SHCreateShellItemArrayFromShellItem(
  [in]  IShellItem *psi,
  [in]  REFIID     riid,
  [out] void       **ppv
);

参数

[in] psi

类型: IShellItem*

指向表示项的 IShellItem 对象的指针。

[in] riid

类型: REFIID

对要通过 ppv 检索的接口的 IID 的引用,通常IID_IShellItemArray。

[out] ppv

类型: void**

此方法返回时,包含 riid 中请求的接口指针。 这通常是指向 IShellItemArray 的指针。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此函数从单个项创建一个单元素数组。 若要从文件夹的内容创建数组,请使用 SHCreateShellItemArray

要求

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