Método ICustomDestinationList::D eleteList (shobjidl_core.h)

  • Artigo

Exclui uma Lista de Saltos personalizada para um aplicativo especificado.

Sintaxe

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Parâmetros

[in] pszAppID

Tipo: LPCWSTR

Um ponteiro para o AppUserModelID do processo cuja representação do botão da barra de tarefas exibe a Lista de Saltos personalizada. Na versão beta do Windows 7, este AppUserModelID deve ser fornecido explicitamente porque esse método se destina a ser chamado de um desinstalador, que é executado em um processo separado. Como ele está em um processo separado, o sistema não pode deduzir de forma confiável o AppUserModelID. Espera-se que essa restrição seja removida em versões posteriores.

Valor retornado

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

Há várias instâncias em que esse método deve ser chamado, incluindo:

  • Quando o aplicativo é desinstalado.
  • Quando o usuário limpa o histórico de dentro do aplicativo.
  • Quando o usuário desabilita o acompanhamento de destino nas páginas Configurações ou Opções do aplicativo.
Esse método não deve ser chamado quando um aplicativo está atualizando uma lista de destino personalizada. Ele é usado apenas para limpar completamente a lista durante uma operação de desinstalação ou se o aplicativo fornecer uma opção para o usuário desativar a lista.

Depois que a Lista de Saltos personalizada for removida, uma Lista de Saltos padrão gerada a partir de dados gerados pelo sistema para itens usados recentemente será mostrada. Se esses dados não tiverem sido coletados ou se as informações tiverem sido limpas por meio de RemoveAllDestinations, a Lista de Saltos poderá conter apenas seu conteúdo mínimo, sempre presente: tarefas padrão para fixar ou desafixar, iniciar uma nova instância do aplicativo ou fechar janelas.

Requisitos

   
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

IDs do modelo de usuário do aplicativo (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

Extensões da barra de tarefas