Interface IIdentityName (shobjidl_core.h)

Expõe métodos para comparar dois itens para ver se eles são iguais.

Herança

A interface IIdentityName herda da interface IRelatedItem.

Comentários

Essa interface fornece apenas os métodos da interface IRelatedItem , da qual herda.

As fontes de dados do Shell que apresentam itens em locais virtuais, como os resultados da pesquisa, normalmente implementam essa interface como um manipulador para descobrir o local real de um item para localizar uma pasta que contém um arquivo. Por exemplo, essa interface é usada para implementar o comando Abrir Local do Arquivo no Windows Explorer. Quando o usuário clica com o botão direito do mouse em um arquivo em um conjunto de resultados de pesquisa, por exemplo, e seleciona Abrir Local do Arquivo, o comando usa IIdentityName para obter o item verdadeiro e abre um navegador em seu pai (a pasta de arquivo) em vez de abrir o pai do item (que é onde o usuário já está).

Vários controles (o botão Iniciar na barra de tarefas e o controle de namespace) usam IIdentityName para obter o item original e, portanto, evitar itens duplicados.

Essa interface é útil com listas de ID de alias (tipo ITEMIDLIST), como pode ser demonstrado usando as duas listas a seguir.

1. [computador] [c:] [usuários] [pat] [área de trabalho] [myfile.txt]. Esse é um arquivo na área de trabalho do usuário e é tratado pela implementação IShellFolder no Windows Vista que manipula sistemas de arquivos.
2. [área de trabalho] [myfile.txt]. A implementação do IShellFolder por trás da área de trabalho mostra arquivos da área de trabalho do usuário, toda a área de trabalho do usuário e alguns itens especiais, como a Lixeira. Quando solicitado a associar por meio de IShellFolder::BindToObject usando IID IID_IIdentityName, este IShellFolder retorna o item subjacente, que é o item de pasta de arquivo logo acima.

Nota Para obter uma instância desse manipulador, use IShellFolder::BindToObject com IID_IIdentityItem ou use IShellItem::BindToHandler com BHID_SFObject.

 

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h