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