Méthode ICustomDestinationList ::SetAppID (shobjidl_core.h)
Spécifie un ID de modèle utilisateur d’application unique (AppUserModelID) pour l’application dont le bouton de barre des tâches contiendra la liste de raccourcis personnalisée générée par les méthodes de cette interface. Cette méthode est facultative.
Syntaxe
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
Paramètres
[in] pszAppID
Type : LPCWSTR
Pointeur vers l’AppUserModelID du processus ou de l’application dont la représentation de la barre des tâches reçoit la liste de raccourcis.
Valeur retournée
Type : HRESULT
Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :
| Code de retour | Description |
|---|---|
|
Cette méthode a été appelée après ICustomDestinationList ::BeginList. Le processus de création de liste est déjà en cours d’exécution avec un AppUserModelID particulier, déduit par le système ou défini via un appel à SetAppID avant l’appel à BeginList. Une fois qu’une opération de création de liste est en cours, appUserModelID ne peut pas être modifié tant que CommitList ou AbortList n’a pas été appelé. |
Remarques
Si une application a un AppUserModelID explicite, vous devez appeler SetAppID avant d’appeler ICustomDestinationList ::BeginList ou ICustomDestinationList ::GetRemovedDestinations.
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 ICustomDestinationList ::BeginList ou ICustomDestinationList ::GetRemovedDestinations sont appelés. 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) |
Voir aussi
ID de modèle utilisateur d’application (AppUserModelIDs)