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)

GetCurrentProcessExplicitAppUserModelID

Taskleistenerweiterungen