IShellFolderView::AddObject-Methode (shlobj_core.h)

[AddObject 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.]

Fügt der Ansicht ein Element hinzu.

Syntax

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

Parameter

[in] pidl

Typ: PUITEMID_CHILD

Ein Zeiger auf eine ItemID, der das Element angibt, das der Ansicht hinzugefügt werden soll.

[out] puItem

Typ: UINT*

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die Indexposition des hinzugefügten Elements empfängt.

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 diesem 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.

Elemente, die über diese Methode hinzugefügt werden, können jederzeit von der Datenquelle aus der Ansicht entfernt werden.

Anforderungen

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