ICustomDestinationList::SetAppID-Methode (shobjidl_core.h)
Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, deren Taskleistenschaltfläche die benutzerdefinierte Sprungliste enthält, die über die Methoden dieser Schnittstelle erstellt wurde. Diese Methode ist optional.
Syntax
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parameter
[in] pszAppID
Typ: LPCWSTR
Ein Zeiger auf die AppUserModelID des Prozesses oder der Anwendung, deren Taskleistendarstellung die Sprungliste empfängt.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
|
Diese Methode wurde nach ICustomDestinationList::BeginList aufgerufen. Der Listenerstellungsprozess wird bereits mit einer bestimmten AppUserModelID ausgeführt, entweder vom System abgeleitet oder durch einen Aufruf von SetAppID vor dem Aufruf von BeginList festgelegt. Nachdem ein Listenerstellungsvorgang ausgeführt wurde, kann die AppUserModelID erst nach dem Aufruf von CommitList oder AbortList geändert werden. |
Hinweise
Wenn eine Anwendung über eine explizite AppUserModelID verfügt, müssen Sie SetAppID aufrufen, bevor Sie ICustomDestinationList::BeginList oder ICustomDestinationList::GetRemovedDestinations aufrufen.
Nachdem eine AppUserModelID durch die SetAppID-Methode eines Objekts angegeben wurde, wird die AppUserModelID für die Lebensdauer dieses Objekts im Objekt gespeichert, vorausgesetzt, es wird nicht durch einen anderen Aufruf von SetAppID überschrieben.
Einige Anwendungen deklarieren keine explizite AppUserModelID und sollten diese Methode nicht aufrufen. In diesem Fall wird die Identität der Anwendung abgeleitet, wenn ICustomDestinationList::BeginList oder ICustomDestinationList::GetRemovedDestinations aufgerufen wird. Die Vermeidung dieser Berechnungen bietet jedoch einen Leistungsvorteil, sodass Anwendungen, die benutzerdefinierte Jump Listen bereitstellen, empfohlen werden, explizite AppUserModelIDs zu verwenden.
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) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 6.1 oder höher) |
Weitere Informationen
Anwendungsbenutzermodell-IDs (AppUserModelIDs)