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。

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