Método ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)

Recupera a lista atual de destinos que foram removidos pelo usuário da Lista de Atalhos existente que esta Lista de Atalhos personalizada deve substituir.

Sintaxe

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[in] riid

Tipo: REFIID

Uma referência ao IID da interface a ser recuperada por meio de ppv, normalmente IID_IObjectArray.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, esse é um IObjectArray, que representa uma coleção de objetos IShellItem ou IShellLink que representam os itens na lista de destinos removidos.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os itens podem ser removidos da interface do usuário da Lista de Atalhos por meio da ação do usuário. Em seguida, o item é marcado como removido e não é mais exibido. Um aplicativo pode usar esse método para informar quais itens o usuário removeu para que ele saiba não mostrá-los em sua lista personalizada. Por exemplo, esse método deve ser chamado quando um aplicativo é iniciado, se esse aplicativo não vai gerar uma nova lista por meio de ICustomDestinationList::BeginList.

É altamente recomendável que um aplicativo limpe todos os dados de rastreamento de destino quando o usuário optar por remover esse destino. Se o usuário acessar esse destino novamente no futuro, ele poderá ser adicionado novamente à Lista de Atalhos e poderá acumular dados novamente. A mesma lista de destinos removidos recuperada por esse método é recuperada quando ICustomDestinationList::BeginList é chamado. Nesse caso, o aplicativo não deve tentar reinserir imediatamente qualquer item removido ou essa chamada para AppendCategory falhará. Isso garante que o aplicativo respeite a intenção do usuário de remover o item.

Se o aplicativo tiver uma ID explícita do Modelo de Usuário do Aplicativo (AppUserModelID), você deverá chamar SetAppID antes de chamar esse método.

Mesmo que um aplicativo chame GetRemovedDestinations e encontre um item na lista que tenha uma alta probabilidade de ser restaurado para a Lista de Atalhos antes de uma nova Lista de Atalhos personalizada ser criada, o aplicativo deverá gravar a Lista de Atalhos sem esse item e adicioná-la novamente à lista somente depois que o usuário o tiver acessado novamente.

Um aplicativo pode adicionar uma categoria conhecidaRecente ou Frequente à sua Lista de Atalhos personalizada. Os itens nessa categoria podem estar na lista de itens removidos, mesmo que não tenham sido mostrados em nenhuma categoria personalizada. Nesse caso, o aplicativo ainda deverá limpar os dados de uso desse item se algum tiver sido armazenado.

Uma chamada para GetRemovedDestinations não limpa os dados de destinos removidos. Esses dados são necessários para BeginList para a próxima geração de lista. Os dados de destinos removidos não são mais necessários e são limpos depois que uma sessão de geração de lista é iniciada por BeginList, continua sem chamadas com falha para AppendCategory e concluída por uma chamada para CommitList.

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

ICustomDestinationList

ICustomDestinationList::BeginList

Extensões da barra de tarefas