IShellFolderView：：UpdateObject 方法 (shlobj_core.h)

  • 项目

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

将视图中的项替换为另一项。

语法

HRESULT UpdateObject(
  [in]  PUITEMID_CHILD pidlOld,
  [in]  PUITEMID_CHILD pidlNew,
  [out] UINT           *puItem
);

参数

[in] pidlOld

类型： PUITEMID_CHILD

原始项。

[in] pidlNew

类型： PUITEMID_CHILD

新项目。

[out] puItem

类型： UINT*

此方法返回时，包含指向被替换项的索引的指针。 稍后可以使用此值调用 IShellFolderView：：GetObject ，以获取刚添加的PITEMID_CHILD。

返回值

类型： HRESULT

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

注解

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

数据源可以随时在视图中放弃通过此方法所做的更改。

要求

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