Share via

Interface IApplicationDestinations (shobjidl_core.h)

  • Article

Expose les méthodes qui permettent à une application de supprimer une ou toutes les destinations des catégories Récents ou Fréquents d’une liste de raccourcis.

Héritage

L’interface IApplicationDestinations hérite de l’interface IUnknown. IApplicationDestinations a également les types de membres suivants :

Méthodes

L’interface IApplicationDestinations possède ces méthodes.

 
IApplicationDestinations ::RemoveAllDestinations

Efface toutes les entrées de destination des catégories Récents et Fréquents dans la liste de raccourcis d’une application.
IApplicationDestinations ::RemoveDestination

Supprime une destination unique des catégories Récents et Fréquents d’une liste de raccourcis.
IApplicationDestinations ::SetAppID

Spécifie un ID de modèle utilisateur d’application unique (AppUserModelID) pour l’application dont 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.

Remarques

Quand implémenter

Une implémentation de cette interface est fournie dans Windows en tant que CLSID_ApplicationDestinations. Cette interface n’est pas implémentée par des tiers.

Quand utiliser

Une application appelle les méthodes de cette interface lorsqu’elle souhaite supprimer des éléments des destinations générées automatiquement d’une liste de raccourcis. Ces destinations, qui se trouvent dans les catégories Récents ou Fréquents, sont générées par le biais d’appels à SHAddToRecentDocs, soit explicitement, soit par le système lorsqu’un fichier est ouvert via Windows Explorer ou que la boîte de dialogue commune de fichier est utilisée pour ouvrir, enregistrer ou créer un fichier.

Une application doit appeler des méthodes IApplicationDestinations dans les situations suivantes :

  • Lorsque l’application est désinstallée.
  • Lorsque l’utilisateur efface l’historique.
  • Lorsque l’utilisateur désactive le suivi de destination dans les pages Paramètres ou Options de l’application.
  • Lorsque l’utilisateur supprime la destination à partir de l’application. Cela est particulièrement important dans le cas d’une destination qui n’est pas un fichier. Dans le cas de destinations autres que des fichiers (généralement, mais pas toujours, les éléments IShellLink ), il incombe à l’application de supprimer la destination de la liste lorsqu’elle détecte qu’elle n’existe plus.

Si l’utilisateur désactive le suivi de l’utilisation dans le paramètre de confidentialité de l’application, l’application est chargée d’effacer les données existantes et d’empêcher le système de collecter des données d’utilisation sur cet élément à l’avenir. Pour ce faire, définissez la valeur NoRecentDocs dans toutes les inscriptions de type de fichier de l’application. Pour plus d’informations, consultez FTA_NoRecentDocs .

Les méthodes IApplicationDestinations sont utilisées uniquement avec les catégories Récents ou Fréquents générées automatiquement. Ils ne suppriment pas les éléments que l’utilisateur a épinglés dans la liste de raccourcis. Ces éléments ne peuvent pas être supprimés par programmation ; seul l’utilisateur peut les supprimer. Ces méthodes n’ont pas non plus d’effet sur les catégories personnalisées ou la liste des tâches.

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 (inclure Shobjidl.h)

Voir aussi

Extensions de la barre des tâches