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