Método IApplicationDestinations::RemoveDestination (shobjidl_core.h)

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

Sintaxe

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

Parâmetros

[in] punk

Tipo: IUnknown*

Um ponteiro para iShellItem ou IShellLink que representa o destino a ser removido.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro COM padrão, caso contrário. Se o objeto apontado pelo punk não for um IShellItem ou IShellLink, o método retornará E_INVALIDARG.

Comentários

Um destino pode aparecer nas categorias Recentes e Frequentes . Se esse for o caso, esse método removerá o destino de ambas as categorias.

Se o item for fixado na lista pelo usuário, ele não será removido, mas seus dados de uso serão limpos.

Um aplicativo pode chamar RemoveDestination sem saber se o item apontado pelo punk está atualmente na lista. Se não houver dados existentes no item (nesse caso, ele não está na lista Recente ou Frequente ), esse método não faz nada e retorna S_OK.

Se o aplicativo tiver uma ID de modelo de usuário de aplicativo explícita (AppUserModelID), você deverá chamar IApplicationDestinations::SetAppID antes de chamar esse método.

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)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 6.1 ou posterior)

Confira também

IApplicationDestinations

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Extensões da barra de tarefas