IApplicationDestinations::SetAppID-Methode (shobjidl_core.h)
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) |