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