IApplicationDestinations::SetAppID-Methode (shobjidl_core.h)

  • Artikel

Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, aus deren Sprungliste die Methoden dieser Schnittstelle Ziele entfernen. Diese Methode ist optional.

Syntax

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

Parameter

[in] pszAppID

Typ: LPCWSTR

Zeiger auf die AppUserModelID des Prozesses, dessen Darstellung der Taskleistenschaltfläche die Sprungliste empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn die Anwendung über eine explizite AppUserModelID verfügt, muss diese Methode aufgerufen werden, bevor Sie RemoveAllDestinations oder RemoveDestination aufrufen.

Nachdem eine AppUserModelID durch die SetAppID-Methode eines Objekts angegeben wurde, wird die AppUserModelID für die Lebensdauer dieses Objekts im Objekt gespeichert, sofern sie nicht durch einen anderen Aufruf von SetAppID überschrieben wird.

Einige Anwendungen deklarieren keine explizite AppUserModelID und sollten diese Methode nicht aufrufen. In diesem Fall wird die Identität der Anwendung abgeleitet, wenn IApplicationDestinations::RemoveDestination oder IApplicationDestinations::RemoveAllDestinations aufgerufen werden. Es gibt jedoch einen Leistungsvorteil, diese Berechnungen zu vermeiden, 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 (einschließlich Shobjidl.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

Anwendungsbenutzermodell-IDs (AppUserModelIDs)

IAnwendungenDestinationen

Taskleistenerweiterungen