IShellFolderView::RemoveObject-Methode (shlobj_core.h)

Artikel
03/02/2024

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

Entfernt ein Element aus der Ansicht.

Syntax

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

Parameter

[in, optional] pidl

Typ: PUITEMID_CHILD

Ein Zeiger auf das Element, das aus der Ansicht entfernt werden soll. Dieser Wert kann NULL sein. Bei Verwendung des Systemordneransichtsobjekts (DefView) unter Windows XP und Windows Vista führt ein NULL-Wert dazu, dass alle Objekte aus der Ansicht entfernt werden.

[out] puItem

Typ: UINT*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Indexposition des entfernten Elements.

Rückgabewert

Typ: HRESULT

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

Hinweise

Elemente, die über diese Methode entfernt wurden, können jederzeit von der Datenquelle in die Ansicht eingelesen 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

Freigeben über