SHCreateItemWithParent 函数 (shobjidl_core.h)

创建一个 Shell 项,给定父文件夹和子项 ID。

语法

SHSTDAPI SHCreateItemWithParent(
  [in]  PCIDLIST_ABSOLUTE pidlParent,
  [in]  IShellFolder      *psfParent,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  REFIID            riid,
  [out] void              **ppvItem
);

参数

[in] pidlParent

类型: PCIDLIST_ABSOLUTE

正在创建的项的父文件夹的 IDList; psfParent 的 IDList。 如果指定了 psfParent,此参数可以为 NULL

[in] psfParent

类型: IShellFolder*

指向 IShellFolder 接口的指针,该接口指定 pidl 指定的子项的 shell 数据源。如果指定了 pidlParent,此参数可以为 NULL

[in] pidl

类型: PCUITEMID_CHILD

相对于 psfParentpidlParent 指定的父文件夹的子项 ID。

[in] riid

类型: REFIID

对接口 ID 的引用。

[out] ppvItem

类型: void**

当此函数返回时,包含 riid 中请求的接口指针。 这通常是 IShellItemIShellItem2

返回值

类型: HRESULT

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

要求

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