Metodo ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)
Recupera l'elenco corrente di destinazioni che sono state rimosse dall'utente dalla Jump List esistente che deve essere sostituita da questa jump list personalizzata.
Sintassi
HRESULT GetRemovedDestinations(
[in] REFIID riid,
[out] void **ppv
);
Parametri
[in] riid
Tipo: REFIID
Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IObjectArray.
[out] ppv
Tipo: void**
Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di un oggetto IObjectArray, che rappresenta una raccolta di oggetti IShellItem o IShellLink che rappresentano gli elementi nell'elenco delle destinazioni rimosse.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Gli elementi possono essere rimossi dall'interfaccia utente della Jump List tramite l'azione dell'utente. L'elemento viene quindi contrassegnato come rimosso e non viene più visualizzato. Un'applicazione può usare questo metodo per indicare quali elementi l'utente ha rimosso in modo da non visualizzarli nell'elenco personalizzato. Ad esempio, questo metodo deve essere chiamato quando viene avviata un'applicazione, se tale applicazione non genererà un nuovo elenco tramite ICustomDestinationList::BeginList.
È consigliabile che un'applicazione cancella tutti i dati di rilevamento della destinazione quando l'utente sceglie di rimuovere tale destinazione. Se l'utente accede nuovamente a tale destinazione in futuro, potrebbe essere aggiunto nuovamente alla Jump List e può accumulare nuovamente i dati. Lo stesso elenco di destinazioni rimosso recuperato da questo metodo viene recuperato quando viene chiamato ICustomDestinationList::BeginList . In tal caso, l'applicazione non deve tentare immediatamente di reinserire alcun elemento rimosso o la chiamata a AppendCategory avrà esito negativo. Ciò garantisce che l'applicazione rispetti la finalità dell'utente di rimuovere l'elemento.
Se l'applicazione ha un ID modello utente applicazione esplicito (AppUserModelID), è necessario chiamare SetAppID prima di chiamare questo metodo.
Anche se un'applicazione chiama GetRemovedDestinations e trova un elemento nell'elenco che ha una probabilità elevata di essere ripristinato nella Jump List prima che venga creato un nuovo jump list personalizzato, l'applicazione deve scrivere la Jump List senza tale elemento e aggiungerla nuovamente all'elenco solo dopo che l'utente ha nuovamente eseguito l'accesso.
Un'applicazione può aggiungere una categoria notarecente o frequente alla jump list personalizzata. Gli elementi della categoria potrebbero trovarsi nell'elenco elementi rimossi anche se non sono stati visualizzati in alcuna categoria personalizzata. In tal caso, l'applicazione deve comunque cancellare tutti i dati di utilizzo per tale elemento, se sono stati archiviati.
Una chiamata a GetRemovedDestinations non cancella i dati delle destinazioni rimosse. Questi dati sono necessari da BeginList per la generazione di elenchi successiva. I dati delle destinazioni rimosse non sono più necessari e vengono cancellati dopo l'avvio di una sessione di generazione di elenchi da BeginList, continua senza chiamate non riuscite a AppendCategory e completate da una chiamata a CommitList.
Requisiti
Requisito | Valore |
---|---|
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) |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per