ICustomDestinationList::GetRemovedDestinations-Methode (shobjidl_core.h)
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 ppvabgerufen werden soll, in der Regel IID_IObjectArray.
[out] ppv
Typ: void**
Wenn diese Methode zurückgegeben wird, enthält den Schnittstellenzeiger, der in riidangefordert wurde. Dies ist in der Regel eine IObjectArray-, die 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_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Elemente können über Eine Benutzeraktion aus der Sprungliste 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 nicht in der benutzerdefinierten Liste angezeigt werden. Diese Methode sollte beispielsweise aufgerufen werden, wenn eine Anwendung gestartet wird, wenn diese Anwendung keine neue Liste über ICustomDestinationList::BeginListgeneriert.
Es wird dringend empfohlen, dass eine Anwendung alle Zielverfolgungsdaten löscht, wenn der Benutzer dieses Ziel entfernen möchte. Wenn der Benutzer in Zukunft erneut auf dieses Ziel zugreift, wird es möglicherweise erneut zur Sprungliste hinzugefügt und kann erneut Daten sammeln. Die von dieser Methode abgerufene Liste der entfernten Ziele wird abgerufen, wenn ICustomDestinationList::BeginList aufgerufen wird. In diesem Fall darf die Anwendung nicht sofort versuchen, entfernte Elemente erneut einzufügen, oder dieser Aufruf von AppendCategory schlägt 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.
Auch wenn eine Anwendung GetRemovedDestinations aufruft und ein Element in der Liste findet, das eine hohe Wahrscheinlichkeit hat, in der Sprungliste früher wiederhergestellt zu werden, als eine neue benutzerdefinierte Sprungliste erstellt wird, sollte die Anwendung die Sprungliste ohne dieses Element schreiben und sie erst dann erneut zur Liste hinzufügen, nachdem der Benutzer erneut darauf zugegriffen hat.
Eine Anwendung kann der benutzerdefinierten Sprungliste eine Zuletzt verwendete oder häufig verwendetebekannte Kategorie hinzufügen. Elemente in dieser Kategorie befinden sich möglicherweise in der Liste der entfernten Elemente, obwohl sie nicht in einer benutzerdefinierten Kategorie angezeigt wurden. In diesem Fall sollte die Anwendung weiterhin Nutzungsdaten für dieses Element löschen, wenn vorhanden.
Ein Aufruf von GetRemovedDestinations löscht die entfernten Zieldaten nicht. Diese Daten werden von BeginList- für die nächste Listengenerierung benötigt. Die entfernten Zieldaten sind nicht mehr erforderlich und werden gelöscht, nachdem eine Sitzung zur Listengenerierung durch BeginList-begonnen wurde, ohne dass Aufrufe an AppendCategoryfortgesetzt und durch einen Aufruf von CommitList-abgeschlossen wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shobjidl_core.h (include Shobjidl.h) |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 6.1 oder höher) |