Compartir a través de

Método ICustomDestinationList::D eleteList (shobjidl_core.h)

  • Artículo

Elimina una lista de accesos directos personalizada para una aplicación especificada.

Sintaxis

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

Parámetros

[in] pszAppID

Tipo: LPCWSTR

Puntero al AppUserModelID del proceso cuya representación del botón de la barra de tareas muestra la lista de accesos directos personalizada. En la versión beta de Windows 7, este AppUserModelID debe proporcionarse explícitamente porque este método está pensado para llamarse desde un desinstalador, que se ejecuta en un proceso independiente. Dado que se encuentra en un proceso independiente, el sistema no puede deducir de forma confiable appUserModelID. Se espera que esta restricción se quite en versiones posteriores.

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

Hay varias instancias en las que se debe llamar a este método, entre las que se incluyen:

  • Cuando se desinstala la aplicación.
  • Cuando el usuario borra el historial desde dentro de la aplicación.
  • Cuando el usuario deshabilita el seguimiento de destino en las páginas Configuración o Opciones de la aplicación.
No se debe llamar a este método cuando una aplicación está actualizando una lista de destino personalizada. Solo se usa para borrar completamente la lista durante una operación de desinstalación, o si la aplicación proporciona una opción para que el usuario desactive la lista.

Una vez quitada la lista de accesos directos personalizada, se muestra una lista de accesos directos estándar generada a partir de datos generados por el sistema para los elementos usados recientemente. Si no se han recopilado estos datos o si la información se ha borrado a través de RemoveAllDestinations, la lista de accesos directos puede contener solo su contenido mínimo, siempre presente contenido: tareas estándar para anclar o desanclar, iniciar una nueva instancia de la aplicación o cerrar ventanas.

Requisitos

   
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 (incluya Shobjidl.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.1 o posterior)

Consulte también

Identificadores de modelo de usuario de aplicación (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

Extensiones de la barra de tareas