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

E_UNEXPECTED

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)

ICustomDestinationList

SetCurrentProcessExplicitAppUserModelID

Taskleistenerweiterungen