Método IApplicationDestinations::RemoveDestination (shobjidl_core.h)
Quita un único destino de las categorías Recientes y Frecuentes de una lista de accesos directos.
Sintaxis
HRESULT RemoveDestination(
[in] IUnknown *punk
);
Parámetros
[in] punk
Tipo: IUnknown*
Puntero al IShellItem o IShellLink que representa el destino que se va a quitar.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK si se ejecuta correctamente o un valor de error COM estándar de lo contrario. Si el objeto al que apunta punk no es un IShellItem o IShellLink, el método devuelve E_INVALIDARG.
Comentarios
Un destino puede aparecer en las categorías Recientes y Frecuentes . Si es así, este método quita el destino de ambas categorías.
Si el usuario ancla el elemento a la lista, no se quita, pero sus datos de uso se borran.
Una aplicación puede llamar a RemoveDestination sin saber si el elemento al que apunta punk está actualmente en la lista. Si no hay datos existentes en el elemento (en cuyo caso no se encuentra en la lista Reciente o Frecuente ), este método no hace nada y devuelve S_OK.
Si la aplicación tiene un identificador de modelo de usuario de aplicación explícito (AppUserModelID), debe llamar a IApplicationDestinations::SetAppID antes de llamar a este método.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Library | Shell32.lib |
| Archivo DLL | Shell32.dll (versión 6.1 o posterior) |
Consulte también
IApplicationDestinations::RemoveAllDestinations