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