IApplicationDestinations-Schnittstelle (shobjidl_core.h)

  • Artikel

Macht Methoden verfügbar, die es einer Anwendung ermöglichen, ein oder alle Ziele aus den Kategorien Zuletzt verwendet oder Häufig in einer Sprungliste zu entfernen.

Vererbung

Die IApplicationDestinations-Schnittstelle erbt von der IUnknown-Schnittstelle . IApplicationDestinations verfügt auch über folgende Membertypen:

Methoden

Die IApplicationDestinations-Schnittstelle verfügt über diese Methoden.

 
IApplicationDestinations::RemoveAllDestinations

Löscht alle Zieleinträge aus den Kategorien Zuletzt verwendet und Häufig in der Sprungliste einer Anwendung.
IApplicationDestinations::RemoveDestination

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

Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, aus deren Sprungliste der Taskleistenschaltfläche die Methoden dieser Schnittstelle Ziele entfernen. Diese Methode ist optional.

Hinweise

Wann sollte implementiert werden?

Eine Implementierung dieser Schnittstelle wird in Windows als CLSID_ApplicationDestinations bereitgestellt. Diese Schnittstelle wird nicht von Dritten implementiert.

Verwendungs-Gründe

Eine Anwendung ruft die Methoden dieser Schnittstelle auf, wenn sie Elemente aus den automatisch generierten Zielen einer Sprungliste entfernen möchte. Diese Ziele, die sich in der Kategorie Zuletzt verwendet oder Häufig befinden, werden durch Aufrufe von SHAddToRecentDocs generiert, entweder explizit oder vom System, wenn eine Datei über Windows Explorer geöffnet wird oder das Allgemeine Dateidialogfeld zum Öffnen, Speichern oder Erstellen einer Datei verwendet wird.

Eine Anwendung sollte in den folgenden Situationen IApplicationDestinations-Methoden aufrufen:

  • Wenn die Anwendung deinstalliert wird.
  • Wenn der Benutzer den Verlauf löscht.
  • Wenn der Benutzer die Zielverfolgung auf den Seiten Einstellungen oder Optionen der Anwendung deaktiviert.
  • Wenn der Benutzer das Ziel aus der Anwendung löscht. Dies ist besonders wichtig, wenn es sich um ein Ziel handelt, das keine Datei ist. Im Fall von Nicht-Dateizielen (in der Regel, wenn auch nicht immer, IShellLink-Elemente ) liegt es in der Verantwortung der Anwendung, das Ziel aus der Liste zu entfernen, wenn sie erkennt, dass es nicht mehr vorhanden ist.

Wenn der Benutzer die Nutzungsnachverfolgung in der Datenschutzeinstellung der Anwendung deaktiviert, ist die Anwendung dafür verantwortlich, die vorhandenen Daten zu löschen und zu verhindern, dass das System in Zukunft Nutzungsdaten für dieses Element sammelt. Dies erfolgt durch Festlegen des NoRecentDocs-Werts in allen Dateitypregistrierungen der Anwendung. Weitere Informationen finden Sie unter FTA_NoRecentDocs .

IApplicationDestinations-Methoden werden nur mit den automatisch generierten Kategorien Zuletzt oder Häufig verwendet. Sie entfernen keine Elemente, die der Benutzer an die Sprungliste angeheftet hat. Diese Elemente können nicht programmgesteuert entfernt werden; nur der Benutzer kann sie entfernen. Diese Methoden haben auch keine Auswirkungen auf benutzerdefinierte Kategorien oder die Aufgabenliste.

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 (shobjidl.h einschließen)

Weitere Informationen

Taskleistenerweiterungen