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

Inicia uma sessão de construção para uma Lista de Saltos personalizada.

Sintaxe

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[out] pcMinSlots

Tipo: UINT*

Um ponteiro que, quando esse método retorna, aponta para a configuração atual do usuário para a opção Número de itens recentes a serem exibidos na opção Pular Listas na janela Propriedades do Menu Iniciar e Barra de Tarefas. O valor padrão é 10. Esse é o número máximo de destinos que serão mostrados e é um total de todos os destinos, independentemente da categoria. Mais destinos podem ser adicionados, mas não serão mostrados na interface do usuário.

Uma Lista de Saltos sempre mostrará pelo menos esses muitos slots: destinos e, se houver espaço, tarefas.

Esse número não inclui separadores e cabeçalhos de seção, desde que o número total de separadores e cabeçalhos não exceda quatro. Separadores e cabeçalhos de seção além dos quatro primeiros podem reduzir o número de destinos exibidos se o espaço for restrito. Esse número não afeta as entradas de comando padrão para fixar ou desafixar, fechar a janela ou iniciar uma nova instância. Ele também não afeta tarefas ou itens fixados, cujo número pode ser exibido é baseado no espaço disponível para a Lista de Saltos.

[in] riid

Tipo: REFIID

Uma referência à IID de uma interface a ser recuperada em ppv, normalmente IID_IObjectArray, que representará todos os itens armazenados atualmente na lista de destinos removidos para o aplicativo. Essas informações são usadas para garantir que os itens removidos não façam parte da nova Lista de Saltos.

[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 e IShellLink que representam os itens 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

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

A interface IObjectArray recuperada no parâmetro ppv representa a mesma lista de destinos removidos recuperados por meio de GetRemovedDestinations. Quando uma nova Lista de Saltos está sendo gerada, os aplicativos devem primeiro processar todos os destinos removidos. Os dados de acompanhamento de qualquer item na lista removida devem ser limpos. Se um aplicativo tentar incluir um item por meio de AppendCategory que está presente nesta lista de destinos removidos, a chamada AppendCategory falhará. Isso garante que os aplicativos respeitem a escolha do usuário de itens removidos. Depois que uma chamada para CommitList é feita sem nenhuma chamada com falha para AppendCategory devido a uma tentativa de adicionar novamente um item removido que foi feito desde BeginList, a lista de destinos removidos é desmarcada. Após esse tempo, um item removido anteriormente poderá retornar à lista de destinos se o usuário continuar a usar o item.

BeginList deve ser chamado para iniciar a lista antes que todas as chamadas sejam feitas para preenchê-la por meio de AppendCategory, AppendKnownCategory ou AddUserTasks.

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

Extensões da barra de tarefas