Metodo IApplicationDocumentLists::GetList (shobjidl_core.h)

Recupera un oggetto che rappresenta l'insieme di destinazioni elencate nella categoria Recenti o Frequenti in una Jump List.

Sintassi

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

Parametri

[in] listtype

Tipo: APPDOCLISTTYPE

Uno dei valori seguenti che specifica da quale categoria deve essere recuperato l'elenco di destinazioni.

ADLT_RECENT (0x0)

0x0. Categoria Recenti , in cui sono elencati gli elementi a cui si accede più di recente.

ADLT_FREQUENT (0x1)

0x1. La categoria Frequente , che elenca gli elementi a cui è stato eseguito l'accesso al maggior numero di volte.

[in] cItemsDesired

Tipo: UINT

Numero di elementi da recuperare dall'elenco specificato in listtype. Impostare questo parametro su 0 per recuperare l'elenco completo.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IObjectArray o IID_IEnumObjects.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di un oggetto IObjectArray o IEnumObjects che rappresenta una raccolta di oggetti IShellItem o IShellLink (o una combinazione dei due) che rappresentano gli elementi recuperati dall'elenco.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un elemento può essere visualizzato negli elenchi Recenti e Frequenti .

Se un utente aggiunge un elemento nelle categorie Recenti o Frequenti , l'elemento non viene più visualizzato nella categoria originale per evitare la duplicazione nella Jump List. Tuttavia, l'elemento verrà comunque restituito da questo metodo.

Requisiti

Vedi anche

IApplicationDocumentLists

IApplicationDocumentLists::SetAppID

Estensioni della barra delle applicazioni