IApplicationDestinations::RemoveDestination-Methode (shobjidl_core.h)

Entfernt ein einzelnes Ziel aus den Kategorien Zuletzt und Häufig in einer Sprungliste.

Syntax

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

Parameter

[in] punk

Typ: IUnknown*

Ein Zeiger auf das IShellItem oder IShellLink , das das zu entfernende Ziel darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Standardfehlerwert zurück. Wenn das Objekt, auf das punk verweist, kein IShellItem oderIShellLink ist, gibt die Methode E_INVALIDARG zurück.

Hinweise

Ein Ziel kann sowohl in der Kategorie Zuletzt als auch häufig angezeigt werden. Wenn dies der Fall ist, entfernt diese Methode das Ziel aus beiden Kategorien.

Wenn das Element vom Benutzer an die Liste angeheftet wird, wird es nicht entfernt, sondern seine Nutzungsdaten werden gelöscht.

Eine Anwendung kann RemoveDestination aufrufen, ohne zu wissen, ob das Element, auf das von Punk verwiesen wird, derzeit in der Liste enthalten ist. Wenn keine Daten für das Element vorhanden sind (in diesem Fall befindet es sich nicht in der Liste Zuletzt oderHäufig ), führt diese Methode nichts aus und gibt S_OK zurück.

Wenn die Anwendung über eine explizite Anwendungsbenutzermodell-ID (AppUserModelID) verfügt, müssen Sie IApplicationDestinations::SetAppID aufrufen, bevor Sie diese Methode aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

IAnwendungenDestinationen

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Taskleistenerweiterungen