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
IApplicationDestinations::RemoveAllDestinations