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::RemoveAllDestinations