IApplicationDocumentLists::SetAppID-Methode (shobjidl_core.h)
Gibt eine eindeutige Anwendungsbenutzermodell-ID (AppUserModelID) für die Anwendung an, deren Ziellisten abgerufen werden. Diese Methode ist optional.
Syntax
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Parameter
[in] pszAppID
Typ: LPCWSTR
Ein 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 GetList 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 IApplicationDocumentLists::GetList aufgerufen wird. Es gibt jedoch einen Leistungsvorteil, wenn diese Berechnungen vermieden werden, sodass Anwendungen, die benutzerdefinierte Sprunglisten bereitstellen, empfohlen werden , explizite AppUserModelIDs zu verwenden.
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 (einschließlich Shobjidl.h) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 6.1 oder höher) |