Partager via


Interface IIdentityName (shobjidl_core.h)

Expose des méthodes pour comparer deux éléments pour voir s’ils sont identiques.

Héritage

L’interface IIdentityName hérite de l’interface IRelatedItem.

Notes

Cette interface fournit uniquement les méthodes de l’interface IRelatedItem , dont elle hérite.

Les sources de données shell qui présentent des éléments dans des emplacements virtuels, tels que les résultats de recherche, implémentent généralement cette interface en tant que gestionnaire pour découvrir l’emplacement réel d’un élément, afin de rechercher un dossier qui contient un fichier. Par exemple, cette interface est utilisée pour implémenter la commande Open File Location dans l’Explorateur Windows. Lorsque l’utilisateur clique avec le bouton droit sur un fichier dans un ensemble de résultats de recherche, par exemple, puis sélectionne Ouvrir l’emplacement du fichier, la commande utilise IIdentityName pour obtenir l’élément vrai et ouvre un navigateur sur son parent (le dossier de fichier) au lieu d’ouvrir le parent de l’élément (où se trouve déjà l’utilisateur).

Plusieurs contrôles (le bouton Démarrer dans la barre des tâches et le contrôle d’espace de noms) utilisent IIdentityName pour obtenir l’élément d’origine et éviter ainsi les éléments en double.

Cette interface est utile avec les listes d’ID avec alias (type ITEMIDLIST), comme vous pouvez le démontrer à l’aide des deux listes suivantes.

  1. [ordinateur] [c:] [utilisateurs] [pat] [desktop] [myfile.txt]. Il s’agit d’un fichier dans le bureau de l’utilisateur qui est géré par l’implémentation IShellFolder dans Windows Vista qui gère les systèmes de fichiers.
  2. [desktop] [myfile.txt]. L’implémentation IShellFolder derrière le bureau affiche les fichiers à partir du bureau de l’utilisateur, de l’ensemble du bureau de l’utilisateur et de certains éléments spéciaux comme la Corbeille. Lorsque vous êtes invité à établir une liaison via IShellFolder::BindToObject à l’aide de l’IID_IIdentityName IID, cet IShellFolder retourne l’élément sous-jacent, qui est l’élément de dossier de fichiers juste au-dessus.
Note Pour obtenir une instance de ce gestionnaire, utilisez IShellFolder::BindToObject avec IID_IIdentityItem ou utilisez IShellItem::BindToHandler avec BHID_SFObject.
 

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h