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

Inicia una sesión de creación para una lista de accesos directos personalizada.

Sintaxis

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parámetros

[out] pcMinSlots

Tipo: UINT*

Puntero que, cuando este método devuelve, apunta a la configuración del usuario actual para el número de elementos recientes que se mostrarán en la opción Jump Listas de la ventana Propiedades del menú Inicio y la barra de tareas. El valor predeterminado es 10. Este es el número máximo de destinos que se mostrarán y es un total de todos los destinos, independientemente de la categoría. Se pueden agregar más destinos, pero no se mostrarán en la interfaz de usuario.

Una lista de accesos directos siempre mostrará al menos estas muchas ranuras: destinos y, si hay espacio, tareas.

Este número no incluye separadores ni encabezados de sección siempre que el número total de separadores y encabezados no supere los cuatro. Los separadores y los encabezados de sección más allá de los cuatro primeros podrían reducir el número de destinos que se muestran si el espacio está restringido. Este número no afecta a las entradas de comando estándar para anclar o desanclar, cerrar la ventana o iniciar una nueva instancia. Tampoco afecta a las tareas ni a los elementos anclados, el número de los cuales se puede mostrar se basa en el espacio disponible para la lista de accesos directos.

[in] riid

Tipo: REFIID

Referencia al IID de una interfaz que se va a recuperar en ppv, normalmente IID_IObjectArray, que representará todos los elementos almacenados actualmente en la lista de destinos eliminados de la aplicación. Esta información se usa para asegurarse de que los elementos eliminados no forman parte de la nueva lista de accesos directos.

[out] ppv

Tipo: void**

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

Valor devuelto

Tipo: HRESULT

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

Comentarios

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

La interfaz IObjectArray recuperada en el parámetro ppv representa la misma lista de destinos eliminados que se recuperan a través de GetRemovedDestinations. Cuando se genera una nueva lista de accesos directos, las aplicaciones deben procesar primero los destinos eliminados. Se deben borrar los datos de seguimiento de cualquier elemento de la lista eliminada. Si una aplicación intenta incluir un elemento a través de AppendCategory que está presente en esta lista de destinos eliminados, se produce un error en la llamada a AppendCategory . Esto garantiza que las aplicaciones respeten la elección del usuario de los elementos quitados. Después de realizar una llamada a CommitList sin ninguna llamada errónea a AppendCategory debido a un intento de volver a agregar un elemento quitado que se ha realizado desde BeginList, se borra la lista de destinos quitados. Después de ese tiempo, un elemento quitado previamente puede volver a la lista de destinos si el usuario sigue usando el elemento.

Se debe llamar a BeginList para iniciar la lista antes de que se realicen llamadas para rellenarla a través de AppendCategory, AppendKnownCategory o AddUserTasks.

Requisitos

Consulte también

ICustomDestinationList

Extensiones de la barra de tareas