ICustomDestinationList::D eleteList-Methode (shobjidl_core.h)

  • Artikel

Löscht eine benutzerdefinierte Sprungliste für eine angegebene Anwendung.

Syntax

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Parameter

[in] pszAppID

Typ: LPCWSTR

Ein Zeiger auf die AppUserModelID des Prozesses, dessen Darstellung der Taskleistenschaltfläche die benutzerdefinierte Sprungliste anzeigt. In der Betaversion von Windows 7 muss diese AppUserModelID explizit bereitgestellt werden, da diese Methode von einem Uninstaller aufgerufen werden soll, der in einem separaten Prozess ausgeführt wird. Da es sich in einem separaten Prozess befindet, kann das System die AppUserModelID nicht zuverlässig ableiten. Es wird erwartet, dass diese Einschränkung in späteren Versionen entfernt wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Es gibt mehrere Instanzen, in denen diese Methode aufgerufen werden sollte, einschließlich:

  • Wenn die Anwendung deinstalliert wird.
  • Wenn der Benutzer den Verlauf innerhalb der Anwendung löscht.
  • Wenn der Benutzer die Zielverfolgung auf den Seiten Einstellungen oder Optionen der Anwendung deaktiviert.
Diese Methode sollte nicht aufgerufen werden, wenn eine Anwendung eine benutzerdefinierte Zielliste aktualisiert. Es wird nur verwendet, um die Liste während eines Deinstallationsvorgangs vollständig zu löschen, oder wenn die Anwendung dem Benutzer eine Option zum Deaktivieren der Liste bereitstellt.

Nachdem die benutzerdefinierte Sprungliste entfernt wurde, wird eine standardmäßige Sprungliste angezeigt, die aus vom System generierten Daten für zuletzt verwendete Elemente generiert wurde. Wenn keine solchen Daten gesammelt wurden oder wenn die Informationen über RemoveAllDestinations gelöscht wurden, enthält die Sprungliste möglicherweise nur den minimalen, immer vorhandenen Inhalt: Standardaufgaben zum Anheften oder Lösen, Starten einer neuen instance der Anwendung oder Schließen von Fenstern.

Anforderungen

   
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)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

Taskleistenerweiterungen