IShellFolderView::UpdateObject-Methode (shlobj_core.h)

Artikel
03/02/2024

[UpdateObject ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Ersetzt ein Element in einer Ansicht durch ein anderes Element.

Syntax

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

Parameter

[in] pidlOld

Typ: PUITEMID_CHILD

Das ursprüngliche Element.

[in] pidlNew

Typ: PUITEMID_CHILD

Das neue Element.

[out] puItem

Typ: UINT*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den Index des ersetzten Elements. Sie können diesen Wert verwenden, um IShellFolderView::GetObject später aufzurufen, um die PITEMID_CHILD abzurufen, die Sie gerade hinzugefügt haben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn Sie IShellFolderView::GetObject sofort mit dem von puItem zurückgegebenen Index aufrufen, erhalten Sie eine Kopie der hinzugefügten ITEMID_CHILD. Die Indexposition eines Elements kann sich jedoch im Laufe der Zeit ändern, sodass code nicht darauf vertrauen kann, dass ein bestimmter Index immer denselben ITEMID_CHILD zurückgibt.

Mit dieser Methode vorgenommene Änderungen können jederzeit von der Datenquelle in der Ansicht verworfen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h