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
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shobjidl_core.h (include Shobjidl.h) |
| Libreria | Shell32.lib |
| DLL | Shell32.dll (versione 6.1 o successiva) |