Méthode ICustomDestinationList ::GetRemovedDestinations (shobjidl_core.h)

Récupère la liste actuelle des destinations qui ont été supprimées par l’utilisateur de la liste de raccourcis existante que cette liste de raccourcis personnalisée est destinée à remplacer.

Syntaxe

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Paramètres

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv , généralement IID_IObjectArray.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid . Il s’agit généralement d’unIObjectArray , qui représente une collection d’objets IShellItem ou IShellLink qui représentent les éléments de la liste des destinations supprimées.

Valeur de retour

Type : HRESULT

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

Remarques

Les éléments peuvent être supprimés de l’interface utilisateur de la liste de raccourcis via l’action de l’utilisateur. L’élément est ensuite marqué comme supprimé et n’est plus affiché. Une application peut utiliser cette méthode pour indiquer quels éléments l’utilisateur a supprimés afin qu’il sache ne pas les afficher dans sa liste personnalisée. Par exemple, cette méthode doit être appelée lorsqu’une application est lancée, si cette application ne va pas générer une nouvelle liste via ICustomDestinationList ::BeginList.

Il est fortement recommandé qu’une application efface toutes les données de suivi de destination lorsque l’utilisateur choisit de supprimer cette destination. Si l’utilisateur accède à nouveau à cette destination à l’avenir, il peut être re-ajouté à la liste de raccourcis et peut à nouveau accumuler des données. La même liste de destinations supprimées récupérée par cette méthode est récupérée lorsque ICustomDestinationList ::BeginList est appelée. Dans ce cas, l’application ne doit pas tenter immédiatement de réinsérer tout élément supprimé ou cet appel à AppendCategory échoue. Cela garantit que l’application respecte l’intention de l’utilisateur de supprimer l’élément.

Si l’application a un ID de modèle utilisateur d’application explicite (AppUserModelID), vous devez appeler SetAppID avant d’appeler cette méthode.

Même si une application appelle GetRemovedDestinations et trouve un élément dans la liste qui a une probabilité élevée d’être restauré dans la liste de raccourcis plus tôt qu’une nouvelle liste de raccourcis personnalisée est censée être créée, l’application doit écrire la liste de raccourcis sans cet élément et l’ajouter à la liste uniquement une fois que l’utilisateur l’a de nouveau accédé.

Une application peut ajouter une récente ou catégorie connue à sa liste de raccourcis personnalisée. Les éléments de cette catégorie peuvent figurer dans la liste des éléments supprimés, même s’ils n’étaient pas affichés dans une catégorie personnalisée. Dans ce cas, l’application doit toujours effacer les données d’utilisation de cet élément si elles avaient été stockées.

Un appel à GetRemovedDestinations ne efface pas les données de destinations supprimées. Ces données sont requises par BeginList pour sa prochaine génération de liste. Les données de destinations supprimées ne sont plus nécessaires et sont effacées une fois qu’une session de génération de liste est commencée par BeginList, continuée sans échec d’appels à AppendCategory, et terminée par un appel à CommitList.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shobjidl_core.h (include Shobjidl.h)
bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.1 ou ultérieure)

Voir aussi

ICustomDestinationList

ICustomDestinationList ::BeginList

extensions de barre des tâches