Condividi tramite

Metodo ICustomDestinationList::D eleteList (shobjidl_core.h)

  • Articolo

Elimina un jump list personalizzato per un'applicazione specificata.

Sintassi

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Parametri

[in] pszAppID

Tipo: LPCWSTR

Puntatore all'AppUserModelID del processo la cui rappresentazione del pulsante della barra delle applicazioni visualizza la jump list personalizzata. Nella versione beta di Windows 7, questo AppUserModelID deve essere specificato in modo esplicito perché questo metodo deve essere chiamato da un programma di disinstallazione, che viene eseguito in un processo separato. Poiché si trova in un processo separato, il sistema non può dedurre in modo affidabile l'AppUserModelID. Questa restrizione dovrebbe essere rimossa nelle versioni successive.

Valore restituito

Tipo: HRESULT

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

Commenti

Esistono diverse istanze in cui è necessario chiamare questo metodo, tra cui:

  • Quando l'applicazione viene disinstallata.
  • Quando l'utente cancella la cronologia dall'interno dell'applicazione.
  • Quando l'utente disabilita il rilevamento della destinazione nelle pagine Impostazioni o Opzioni dell'applicazione.
Questo metodo non deve essere chiamato quando un'applicazione aggiorna un elenco di destinazione personalizzato. Viene usato solo per cancellare completamente l'elenco durante un'operazione di disinstallazione o se l'applicazione fornisce un'opzione per l'utente per disattivare l'elenco.

Dopo la rimozione della Jump List personalizzata, viene visualizzato un jump list standard generato dai dati generati dal sistema per gli elementi usati di recente. Se tali dati non sono stati raccolti o se le informazioni sono state cancellate tramite RemoveAllDestinations, la Jump List potrebbe contenere solo il contenuto minimo, sempre presente: attività standard da aggiungere o rimuovere, avviare una nuova istanza dell'applicazione o chiudere le finestre.

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)

Vedi anche

ID modello utente applicazione (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

Estensioni della barra delle applicazioni