Método IApplicationDocumentLists::GetList (shobjidl_core.h)
Recupera un objeto que representa la colección de destinos enumerados en la categoría Recent o Frequent en una jump List.
Sintaxis
HRESULT GetList(
[in] APPDOCLISTTYPE listtype,
[in] UINT cItemsDesired,
[in] REFIID riid,
[out] void **ppv
);
Parámetros
[in] listtype
Tipo: APPDOCLISTTYPE
Uno de los valores siguientes que especifica de qué categoría se debe recuperar la lista de destinos.
ADLT_RECENT (0x0)
0x0. La categoría Recientes , que enumera los elementos a los que se ha accedido más recientemente.
ADLT_FREQUENT (0x1)
0x1. La categoría Frecuente , que enumera los elementos a los que se ha accedido el mayor número de veces.
[in] cItemsDesired
Tipo: UINT
Número de elementos que se van a recuperar de la lista especificada en listtype. Establezca este parámetro en 0 para recuperar la lista completa.
[in] riid
Tipo: REFIID
Referencia al IID de la interfaz que se va a recuperar a través de ppv, normalmente IID_IObjectArray o IID_IEnumObjects.
[out] ppv
Tipo: void**
Cuando este método vuelve, contiene el puntero de interfaz solicitado en riid. Suele ser un IObjectArray o IEnumObjects que representa una colección de objetos IShellItem o IShellLink (o una combinación de los dos) que representan los elementos recuperados de la lista.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Un elemento puede aparecer en las listas recientes y frecuentes .
Si un usuario ancla un elemento en las categorías Recientes o Frecuentes , el elemento ya no se muestra en su categoría original para evitar la duplicación en la lista de accesos directos. Sin embargo, este método seguirá devolviendo el elemento.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 6.1 o posterior) |