SetCurrentProcessExplicitAppUserModelID-Funktion (shobjidl_core.h)
Gibt eine eindeutige anwendungsdefinierte Anwendungsbenutzermodell-ID (AppUserModelID) an, die den aktuellen Prozess auf der Taskleiste identifiziert. Dieser Bezeichner ermöglicht es einer Anwendung, ihre zugeordneten Prozesse und Fenster unter einer einzelnen Taskleistenschaltfläche zu gruppieren.
Syntax
SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
[in] PCWSTR AppID
);
Parameter
[in] AppID
Typ: PCWSTR
Zeiger auf die AppUserModelID, die dem aktuellen Prozess zugewiesen werden soll.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode muss während der anfänglichen Startroutine einer Anwendung aufgerufen werden, bevor die Anwendung eine Benutzeroberfläche vorgibt oder eine Bearbeitung der Jump-Listen vornimmt. Dies schließt jeden Aufruf von SHAddToRecentDocs ein.
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)