Método IApplicationDocumentLists::GetList (shobjidl_core.h)

  • Artigo

Recupera um objeto que representa a coleção de destinos listados na categoria Recente ou Frequente em uma Lista de Saltos.

Sintaxe

HRESULT GetList(
  [in]  APPDOCLISTTYPE listtype,
  [in]  UINT           cItemsDesired,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parâmetros

[in] listtype

Tipo: APPDOCLISTTYPE

Um dos valores a seguir que especifica de qual categoria a lista de destinos deve ser recuperada.

ADLT_RECENT (0x0)

0x0. A categoria Recent , que lista esses itens acessados mais recentemente.

ADLT_FREQUENT (0x1)

0x1. A categoria Frequente , que lista os itens que foram acessados o maior número de vezes.

[in] cItemsDesired

Tipo: UINT

O número de itens a serem recuperados da lista especificada em listtype. Defina esse parâmetro como 0 para recuperar a lista completa.

[in] riid

Tipo: REFIID

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

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é um IObjectArray ou IEnumObjects que representa uma coleção de objetos IShellItem ou IShellLink (ou uma combinação dos dois) que representam os itens recuperados da lista.

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

Um item pode aparecer nas listas Recentes e Frequentes .

Se um usuário fixar um item nas categorias Recentes ou Frequentes , o item não será mais mostrado em sua categoria original para evitar a duplicação na Lista de Saltos. No entanto, o item ainda será retornado por esse método.

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

IApplicationDocumentLists

IApplicationDocumentLists::SetAppID

Extensões da barra de tarefas