Metodo ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)

Recupera l'elenco corrente di destinazioni che sono state rimosse dall'utente dalla Jump List esistente che questa jump list personalizzata deve sostituire.

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 IObjectArray, che rappresenta un insieme di IShellItem o oggetti 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.

Osservazioni

Gli elementi possono essere rimossi dall'interfaccia utente 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 elimini 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 nuovamente aggiunto alla Jump List e può accumulare nuovamente i dati. Lo stesso elenco delle destinazioni rimosse 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 che la chiamata a AppendCategory avrà esito negativo. In questo modo l'applicazione rispetta 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 con 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 recenti o categoria nota alla jump list personalizzata. Gli elementi in tale 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 BeginList per la successiva generazione di elenchi. I dati delle destinazioni rimosse non sono più necessari e vengono cancellati dopo l'avvio di una sessione di generazione di elenchi da BeginList, continuando senza chiamate non riuscite a AppendCategorye completati da una chiamata a CommitList.

Fabbisogno

Vedere anche

ICustomDestinationList

ICustomDestinationList::BeginList

estensioni della barra delle applicazioni