Export (0) Print
Expand All

ICustomDestinationList::DeleteList method

Deletes a custom Jump List for a specified application.

Syntax


HRESULT DeleteList(
  [in]  LPCWSTR pszAppID
);

Parameters

pszAppID [in]

Type: LPCWSTR

A pointer to the AppUserModelID of the process whose taskbar button representation displays the custom Jump List. In the beta release of Windows 7, this AppUserModelID must be explicitly provided because this method is intended to be called from an uninstaller, which runs in a separate process. Because it is in a separate process, the system cannot reliably deduce the AppUserModelID. This restriction is expected to be removed in later releases.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

There are several instances where this method should be called, including:

  • When the application is uninstalled.
  • When the user clears history from within the application.
  • When the user disables destination tracking in the application's Settings or Options pages.

This method should not be called when an application is updating a custom destination list. It is used only to completely clear the list during an uninstall operation, or if the application provides an option for the user to turn off the list.

After the custom Jump List has been removed, a standard Jump List generated from system-generated data for recently used items is shown. If no such data has been collected or if the information has been cleared through RemoveAllDestinations, the Jump List might contain only its minimum, always present content: standard tasks to pin or unpin, launch a new instance of the application, or close windows.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

Library

Shell32.lib

DLL

Shell32.dll (version 6.1 or later)

See also

ICustomDestinationList
ICustomDestinationList::SetAppID
Application User Model IDs (AppUserModelIDs)
Taskbar Extensions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft