GetCurrentProcessExplicitAppUserModelID, fonction (shobjidl_core.h)

  • Article

Récupère l’ID de modèle utilisateur d’application explicite défini par l’application (AppUserModelID) pour le processus actuel.

Syntaxe

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

Paramètres

[out] AppID

Type : PWSTR*

Pointeur qui reçoit l’adresse du AppUserModelID affecté au processus. L’appelant est chargé de libérer cette chaîne avec CoTaskMemFree quand elle n’est plus nécessaire.

Valeur retournée

Type : HRESULT

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

Remarques

L’AppUserModelID récupéré par cette fonction a été défini précédemment via SetCurrentProcessExplicitAppUserModelID.

Une application peut uniquement récupérer un AppUserModelID qui a été défini explicitement. Les appUserModelIDs par défaut attribués par le système ne peuvent pas être récupérés. Si l’application nécessite une connaissance de son AppUserModelID, elle doit en définir un explicitement.

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 (incluez 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)

IObjectWithAppUserModelID ::GetAppID

Extensions de la barre des tâches