Interfaz IApplicationDestinations (shobjidl_core.h)

  • Artículo

Expone métodos que permiten a una aplicación quitar uno o todos los destinos de las categorías Recientes o Frecuentes en una lista de accesos directos.

Herencia

La interfaz IApplicationDestinations hereda de la interfaz IUnknown . IApplicationDestinations también tiene estos tipos de miembros:

Métodos

La interfaz IApplicationDestinations tiene estos métodos.

 
IApplicationDestinations::RemoveAllDestinations

Borra todas las entradas de destino de las categorías Recientes y Frecuentes de la lista de accesos directos de una aplicación.
IApplicationDestinations::RemoveDestination

Quita un único destino de las categorías Recientes y Frecuentes de una lista de accesos directos.
IApplicationDestinations::SetAppID

Especifica un identificador de modelo de usuario de aplicación único (AppUserModelID) para la aplicación desde cuya lista de accesos directos del botón de la barra de tareas los métodos de esta interfaz quitarán los destinos. Este método es opcional.

Comentarios

Cuándo implementar

Se proporciona una implementación de esta interfaz en Windows como CLSID_ApplicationDestinations. Esta interfaz no la implementan terceros.

Cuándo usar

Una aplicación llama a los métodos de esta interfaz cuando desea quitar elementos de los destinos generados automáticamente por una lista de accesos directos. Estos destinos, que se encuentran en las categorías Recientes o Frecuentes , se generan mediante llamadas a SHAddToRecentDocs, ya sea explícitamente o por el sistema cuando se abre un archivo a través del Explorador de Windows o el cuadro de diálogo de archivo común se usa para abrir, guardar o crear un archivo.

Una aplicación debe llamar a métodos IApplicationDestinations en las situaciones siguientes:

  • Cuando se desinstala la aplicación.
  • Cuando el usuario borra el historial.
  • Cuando el usuario deshabilita el seguimiento de destino en las páginas Configuración o Opciones de la aplicación.
  • Cuando el usuario elimina el destino de dentro de la aplicación. Esto es especialmente importante en el caso de un destino que no es un archivo. En el caso de destinos que no son de archivo(por lo general, aunque no siempre, elementos de IShellLink ), es responsabilidad de la aplicación quitar el destino de la lista cuando detecta que ya no existe.

Si el usuario desactiva el seguimiento de uso en la configuración de privacidad de la aplicación, la aplicación es responsable de borrar los datos existentes y también detener que el sistema recopile datos de uso en ese elemento en el futuro. Esto se hace estableciendo el valor NoRecentDocs en todos los registros de tipo de archivo de la aplicación. Consulte FTA_NoRecentDocs para obtener más información.

Los métodos IApplicationDestinations solo se usan con las categorías recientes o frecuentes generadas automáticamente. No quitan los elementos que el usuario ha anclado a la lista de accesos directos. Esos elementos no se pueden quitar mediante programación; solo el usuario puede quitarlos. Estos métodos tampoco tienen ningún efecto en las categorías personalizadas ni en la lista de tareas.

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)

Consulte también

Extensiones de la barra de tareas