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

IApplicationDestinations::RemoveAllDestinations

IApplicationDestinations::SetAppID

Extensiones de la barra de tareas