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

Artigo
07/16/2024

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

Sintaxe

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

Parâmetros

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: void**

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

Valor de retorno

Tipo: HRESULT

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

Observações

Os itens podem ser removidos da interface do usuário do Jump List 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 acompanhamento 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 Saltos 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 de Modelo de Usuário de Aplicativo explícita (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 Saltos mais cedo do que uma nova Lista de Saltos personalizada deverá ser criada, o aplicativo deve gravar a Lista de Saltos sem esse item e adicioná-la novamente à lista somente depois que o usuário tiver acessado novamente.

Um aplicativo pode adicionar um recentes ou de categoria conhecidafrequente à sua Lista de Saltos 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 deve 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 BeginList para sua 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, continuado sem chamadas com falha para AppendCategory e concluído por uma chamada para CommitList.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
biblioteca	Shell32.lib
de DLL	Shell32.dll (versão 6.1 ou posterior)

Consulte também

ICustomDestinationList

ICustomDestinationList::BeginList

extensões da barra de tarefas

Compartilhar via