Freigeben über


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