Metodo IApplicationDestinations::RemoveDestination (shobjidl_core.h)
Rimuove una singola destinazione dalle categorie Recenti e Frequenti in una Jump List.
Sintassi
HRESULT RemoveDestination(
[in] IUnknown *punk
);
Parametri
[in] punk
Tipo: IUnknown*
Puntatore a IShellItem o IShellLink che rappresenta la destinazione da rimuovere.
Valore restituito
Tipo: HRESULT
Restituisce S_OK in caso di esito positivo o un valore di errore COM standard in caso contrario. Se l'oggetto a cui punta punk non è un IShellItem o IShellLink, il metodo restituisce E_INVALIDARG.
Commenti
Una destinazione può essere visualizzata nelle categorie Recenti e Frequenti . In tal caso, questo metodo rimuove la destinazione da entrambe le categorie.
Se l'elemento viene aggiunto all'elenco dall'utente, non viene rimosso ma i relativi dati di utilizzo vengono cancellati.
Un'applicazione può chiamare RemoveDestination senza sapere se l'elemento a cui punta punk è attualmente presente nell'elenco. Se non sono presenti dati sull'elemento (nel qual caso non si trova nell'elenco Recente o Frequente ), questo metodo non esegue alcuna operazione e restituisce S_OK.
Se l'applicazione ha un ID modello utente applicazione esplicito (AppUserModelID), è necessario chiamare IApplicationDestinations::SetAppID prima di chiamare questo metodo.
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
IApplicationDestinations::RemoveAllDestinations