Partager via

Méthode ICustomDestinationList::D eleteList (shobjidl_core.h)

  • Article

Supprime une liste de raccourcis personnalisée pour une application spécifiée.

Syntaxe

HRESULT DeleteList(
  [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 affiche la liste de raccourcis personnalisée. Dans la version bêta de Windows 7, cet AppUserModelID doit être fourni explicitement, car cette méthode est destinée à être appelée à partir d’un programme de désinstallation, qui s’exécute dans un processus distinct. Étant donné qu’il se trouve dans un processus distinct, le système ne peut pas déduire de manière fiable l’AppUserModelID. Cette restriction devrait être supprimée dans les versions ultérieures.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Il existe plusieurs instances où cette méthode doit être appelée, notamment :

  • Quand l’application est désinstallée.
  • Lorsque l’utilisateur efface l’historique de l’application.
  • Lorsque l’utilisateur désactive le suivi de destination dans les pages Paramètres ou Options de l’application.
Cette méthode ne doit pas être appelée lorsqu’une application met à jour une liste de destination personnalisée. Elle est utilisée uniquement pour effacer complètement la liste lors d’une opération de désinstallation, ou si l’application fournit une option permettant à l’utilisateur de désactiver la liste.

Une fois la liste de raccourcis personnalisée supprimée, une liste de raccourcis standard générée à partir des données générées par le système pour les éléments récemment utilisés s’affiche. Si aucune donnée de ce type n’a été collectée ou si les informations ont été effacées via RemoveAllDestinations, la liste de raccourcis peut contenir uniquement son contenu minimal et toujours présent : tâches standard à épingler ou désépingler, lancer une nouvelle instance de l’application ou fermer des fenêtres.

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 (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)

ICustomDestinationList

ICustomDestinationList::SetAppID

Extensions de la barre des tâches