Share via

ICustomDestinationList::GetRemovedDestinations-Methode (shobjidl_core.h)

  • Artikel

Ruft die aktuelle Liste der Ziele ab, die vom Benutzer aus der vorhandenen Sprungliste entfernt wurden, die diese benutzerdefinierte Sprungliste ersetzen soll.

Syntax

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Typ: REFIID

Ein Verweis auf die IID der Schnittstelle, die über ppv abgerufen werden soll, in der Regel IID_IObjectArray.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein IObjectArray, das eine Auflistung von IShellItem- oder IShellLink-Objekten darstellt, die die Elemente in der Liste der entfernten Ziele darstellen.

Rückgabewert

Typ: HRESULT

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

Hinweise

Elemente können über eine Benutzeraktion aus der Jump List-Benutzeroberfläche entfernt werden. Das Element wird dann als entfernt markiert und nicht mehr angezeigt. Eine Anwendung kann diese Methode verwenden, um zu ermitteln, welche Elemente der Benutzer entfernt hat, damit sie diese nicht in der benutzerdefinierten Liste anzeigen kann. Für instance sollte diese Methode aufgerufen werden, wenn eine Anwendung gestartet wird, wenn diese Anwendung keine neue Liste über ICustomDestinationList::BeginList generiert.

Es wird dringend empfohlen, dass eine Anwendung alle Zielverfolgungsdaten löscht, wenn der Benutzer dieses Ziel entfernt. Wenn der Benutzer in Zukunft erneut auf dieses Ziel zugreift, kann es der Sprungliste erneut hinzugefügt werden und kann erneut Daten sammeln. Die gleiche Liste entfernter Ziele, die von dieser Methode abgerufen wird, wird abgerufen, wenn ICustomDestinationList::BeginList aufgerufen wird. In diesem Fall darf die Anwendung nicht sofort versuchen, ein entferntes Element erneut einzufügen. Andernfalls schlägt der Aufruf von AppendCategory fehl. Dadurch wird sichergestellt, dass die Anwendung die Absicht des Benutzers respektiert, das Element zu entfernen.

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

Selbst wenn eine Anwendung GetRemovedDestinations aufruft und ein Element in der Liste findet, das eine hohe Wahrscheinlichkeit hat, dass es früher in der Sprungliste wiederhergestellt wird, als eine neue benutzerdefinierte Sprungliste erstellt werden soll, sollte die Anwendung die Sprungliste ohne dieses Element schreiben und der Liste erst dann erneut hinzufügen, nachdem der Benutzer erneut darauf zugegriffen hat.

Eine Anwendung kann ihrer benutzerdefinierten Sprungliste eine bekannte KategorieZuletzt oder Häufig hinzufügen. Elemente in dieser Kategorie befinden sich möglicherweise in der Liste entfernter Elemente, obwohl sie in keiner benutzerdefinierten Kategorie angezeigt wurden. In diesem Fall sollte die Anwendung weiterhin alle Nutzungsdaten für dieses Element löschen, sofern diese gespeichert wurden.

Ein Aufruf von GetRemovedDestinations löscht die entfernten Zieldaten nicht. Diese Daten werden von BeginList für die nächste Listengeneration benötigt. Die entfernten Zieldaten sind nicht mehr erforderlich und werden gelöscht, nachdem eine Sitzung zur Listengenerierung von BeginList gestartet, ohne fehlerhafte Aufrufe von AppendCategory fortgesetzt und durch einen Aufruf von CommitList abgeschlossen wurde.

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

ICustomDestinationList

ICustomDestinationList::BeginList

Taskleistenerweiterungen