GetCurrentProcessExplicitAppUserModelID, fonction (shobjidl_core.h)
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)