Méthode IApplicationDestinations ::SetAppID (shobjidl_core.h)
Spécifie un ID de modèle utilisateur d’application unique (AppUserModelID) pour l’application à partir de laquelle la liste de raccourcis du bouton de la barre des tâches, les méthodes de cette interface suppriment les destinations. 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 RemoveAllDestinations ou RemoveDestinations.
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 ne soit pas remplacé par un autre appel à SetAppID.
Certaines applications ne déclarent pas d’appUserModelID explicite et ne doivent pas appeler cette méthode. Dans ce cas, l’identité de l’application est déduite lorsque IApplicationDestinations ::RemoveDestinations ou IApplicationDestinations ::RemoveAllDestinations sont appelées . Toutefois, l’évitement de ces calculs présente un avantage en matière de performances, de sorte que les applications qui fournissent des Listes jump personnalisées sont encouragées à utiliser des AppUserModelID explicites.
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) |