IShellFolderView：：AddObject 方法 (shlobj_core.h)

  • 项目

[AddObject 可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]

将项添加到视图。

语法

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

参数

[in] pidl

类型： PUITEMID_CHILD

指向 ItemID 的指针，指定要添加到视图的项。

[out] puItem

类型： UINT*

指向一个值的指针，当此方法成功返回时，该值接收所添加项的索引位置。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果立即使用此索引调用 IShellFolderView：：GetObject ，你将获得添加的ITEMID_CHILD的副本。 但是，项的索引位置可能会随时间而改变，因此代码不能相信任何特定索引始终返回相同的ITEMID_CHILD。

通过此方法添加的项可以随时由数据源从视图中删除。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h