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。

透過此方法所做的變更可以隨時由數據源在檢視中捨棄。