Método ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)

Recupera la lista actual de destinos que el usuario ha quitado de la lista de accesos directos existente que está pensada para reemplazar esta lista de accesos directos personalizada.

Sintaxis

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parámetros

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que se va a recuperar a través de ppv , normalmente IID_IObjectArray.

[out] ppv

Tipo: void**

Cuando este método devuelve , contiene el puntero de interfaz solicitado en riid. Normalmente se trata de un IObjectArray, que representa una colección de IShellItem o objetos IShellLink que representan los elementos de la lista de destinos eliminados.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Los elementos se pueden quitar de la interfaz de usuario de Jump List a través de la acción del usuario. A continuación, el elemento se marca como quitado y ya no se muestra. Una aplicación puede usar este método para indicar qué elementos ha quitado el usuario para que sepa no mostrarlos en su lista personalizada. Por ejemplo, se debe llamar a este método cuando se inicia una aplicación, si esa aplicación no va a generar una nueva lista a través de ICustomDestinationList::BeginList.

Se recomienda encarecidamente que una aplicación borre los datos de seguimiento de destino cuando el usuario decida quitar ese destino. Si el usuario accede a ese destino de nuevo en el futuro, puede volver a agregarse a la lista de accesos directos y volver a acumular datos. La misma lista de destinos eliminados recuperada por este método se recupera cuando se llama a ICustomDestinationList::BeginList. En ese caso, la aplicación no debe intentar reinsertar inmediatamente ningún elemento quitado o que llame a appendCategory producirá un error. Esto garantiza que la aplicación respete la intención del usuario de quitar el elemento.

Si la aplicación tiene un identificador de modelo de usuario de aplicación explícito (AppUserModelID), debe llamar a SetAppID antes de llamar a este método.

Incluso si una aplicación llama a GetRemovedDestinations y encuentra un elemento en la lista que tiene una probabilidad alta de restaurarse a la lista de accesos directos antes de que se cree una nueva lista de accesos directos personalizada, la aplicación debe escribir la lista de accesos directos sin ese elemento y volver a agregarla a la lista solo después de que el usuario haya vuelto a acceder a ella.

Una aplicación puede agregar una reciente o categoría conocida defrecuente a su lista de accesos directos personalizada. Los elementos de esa categoría podrían estar en la lista de elementos eliminados aunque no se mostraran en ninguna categoría personalizada. En ese caso, la aplicación todavía debe borrar los datos de uso de ese elemento si se hubiera almacenado alguno.

Una llamada a GetRemovedDestinations no borra los datos de destinos eliminados. Estos datos los necesita BeginList para su próxima generación de listas. Los datos de destinos eliminados ya no son necesarios y se borran después de iniciar una sesión de generación de listas BeginList, continuando sin llamadas erróneas a AppendCategoryy completadas por una llamada a CommitList.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7 [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 R2 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shobjidl_core.h (incluya Shobjidl.h)
biblioteca de	Shell32.lib
DLL de	Shell32.dll (versión 6.1 o posterior)

Consulte también

ICustomDestinationList

ICustomDestinationList::BeginList

extensiones de la barra de tareas de