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

ICustomDestinationList

ICustomDestinationList::BeginList

Estensioni della barra delle applicazioni