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

  • Artículo

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)

Consulte también

IApplicationDocumentLists

IApplicationDocumentLists::SetAppID

Extensiones de la barra de tareas