Fonction SetCurrentProcessExplicitAppUserModelID (shobjidl_core.h)

Spécifie un ID de modèle utilisateur d’application (AppUserModelID) unique défini par l’application qui identifie le processus en cours dans la barre des tâches. Cet identificateur permet à une application de regrouper ses processus et fenêtres associés sous un seul bouton de la barre des tâches.

Syntaxe

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

Paramètres

[in] AppID

Type : PCWSTR

Pointeur vers appUserModelID à affecter au processus en cours.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode doit être appelée lors de la routine de démarrage initiale d’une application avant que l’application ne présente une interface utilisateur ou effectue une manipulation de son Listes Jump. Cela inclut tout appel à SHAddToRecentDocs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.1 ou ultérieure)

Voir aussi

ID de modèle utilisateur d’application (AppUserModelIDs)

GetCurrentProcessExplicitAppUserModelID

Extensions de la barre des tâches