Méthode IApplicationDocumentLists::SetAppID (shobjidl_core.h)
Spécifie un ID de modèle utilisateur d’application unique (AppUserModelID) pour l’application dont les listes de destination sont récupérées. Cette méthode est facultative.
Syntaxe
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Paramètres
[in] pszAppID
Type : LPCWSTR
Pointeur vers l’AppUserModelID du processus dont la représentation du bouton de la barre des tâches reçoit la liste de raccourcis.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Si l’application a un AppUserModelID explicite, cette méthode doit être appelée avant d’appeler GetList.
Une fois qu’un AppUserModelID est spécifié via la méthode SetAppID d’un objet, l’AppUserModelID est enregistré dans l’objet pour la durée de vie de cet objet, à condition qu’il n’est pas remplacé par un autre appel à SetAppID.
Certaines applications ne déclarent pas un AppUserModelID explicite et ne doivent pas appeler cette méthode. Dans ce cas, l’identité de l’application est déduite lorsque IApplicationDocumentLists::GetList est appelé. Toutefois, le fait d’éviter ces calculs présente un avantage en termes de performances, de sorte que les applications qui fournissent des listes de raccourcis personnalisées sont encouragées à utiliser des AppUserModelID explicites.
Configuration requise
| 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) |