Método IApplicationDocumentLists::GetList (shobjidl_core.h)
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) |