Méthode IApplicationDestinations ::RemoveDestination (shobjidl_core.h)
Supprime une destination unique des catégories Récents et Fréquents d’une liste de raccourcis.
Syntaxe
HRESULT RemoveDestination(
[in] IUnknown *punk
);
Paramètres
[in] punk
Type : IUnknown*
Pointeur vers IShellItem ou IShellLink qui représente la destination à supprimer.
Valeur retournée
Type : HRESULT
Retourne S_OK en cas de réussite, ou une valeur d’erreur COM standard dans le cas contraire. Si l’objet pointé par punk n’est pas un IShellItem ou IShellLink, la méthode retourne E_INVALIDARG.
Remarques
Une destination peut apparaître dans les catégories Récents et Fréquents . Si tel est le cas, cette méthode supprime la destination des deux catégories.
Si l’élément est épinglé à la liste par l’utilisateur, il n’est pas supprimé, mais ses données d’utilisation sont effacées.
Une application peut appeler RemoveDestination sans savoir si l’élément pointé par punk figure actuellement dans la liste. S’il n’existe aucune donnée sur l’élément (auquel cas il ne figure pas dans la liste Récents ou Fréquents ), cette méthode ne fait rien et retourne S_OK.
Si l’application a un ID de modèle utilisateur d’application explicite (AppUserModelID), vous devez appeler IApplicationDestinations ::SetAppID avant d’appeler cette méthode.
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 (incluez Shobjidl.h) |
| Bibliothèque | Shell32.lib |
| DLL | Shell32.dll (version 6.1 ou ultérieure) |
Voir aussi
IApplicationDestinations ::RemoveAllDestinations