Compartilhar via

Interface IApplicationDestinations (shobjidl_core.h)

  • Artigo

Expõe métodos que permitem que um aplicativo remova um ou todos os destinos das categorias Recentes ou Frequentes em uma Lista de Saltos.

Herança

A interface IApplicationDestinations herda da interface IUnknown . IApplicationDestinations também tem esses tipos de membros:

Métodos

A interface IApplicationDestinations tem esses métodos.

 
IApplicationDestinations::RemoveAllDestinations

Limpa todas as entradas de destino das categorias Recentes e Frequentes na Lista de Saltos de um aplicativo.
IApplicationDestinations::RemoveDestination

Remove um único destino das categorias Recentes e Frequentes em uma Lista de Saltos.
IApplicationDestinations::SetAppID

Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) para o aplicativo de cuja Lista de Saltos do botão da barra de tarefas os métodos dessa interface removerão destinos. Esse método é opcional.

Comentários

Quando implementar

Uma implementação dessa interface é fornecida no Windows como CLSID_ApplicationDestinations. Essa interface não é implementada por terceiros.

Quando usar

Um aplicativo chama os métodos dessa interface quando deseja remover itens de destinos gerados automaticamente por uma Lista de Saltos. Esses destinos, encontrados nas categorias Recentes ou Frequentes, são gerados por meio de chamadas para SHAddToRecentDocs, explicitamente ou pelo sistema quando um arquivo é aberto por meio do Windows Explorer ou a caixa de diálogo de arquivo comum é usada para abrir, salvar ou criar um arquivo.

Um aplicativo deve chamar métodos IApplicationDestinations nas seguintes situações:

  • Quando o aplicativo é desinstalado.
  • Quando o usuário limpa o histórico.
  • Quando o usuário desabilita o acompanhamento de destino nas páginas Configurações ou Opções do aplicativo.
  • Quando o usuário exclui o destino de dentro do aplicativo. Isso é particularmente importante no caso de um destino que não é um arquivo. No caso de destinos que não sejam de arquivos, geralmente, embora nem sempre, itens IShellLink , é responsabilidade do aplicativo remover o destino da lista quando detectar que ele não existe mais.

Se o usuário desativar o controle de uso na configuração de privacidade do aplicativo, o aplicativo será responsável por limpar os dados existentes e também impedir que o sistema colete dados de uso nesse item no futuro. Isso é feito definindo o valor NoRecentDocs em todos os registros de tipo de arquivo do aplicativo. Consulte FTA_NoRecentDocs para obter mais informações.

Os métodos IApplicationDestinations são usados apenas com as categorias Recentes ou Frequentes geradas automaticamente. Eles não removem itens que o usuário fixou na Lista de Saltos. Esses itens não podem ser removidos programaticamente; somente o usuário pode removê-los. Esses métodos também não têm efeito em categorias personalizadas ou na lista de tarefas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

Extensões da barra de tarefas