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

Article
08/26/2023

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

Partager via