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

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Estensioni della barra delle applicazioni