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

Voir aussi

ID de modèle utilisateur d’application (AppUserModelIDs)

IApplicationDestinations

Extensions de la barre des tâches