ICustomDestinationList::DeleteList method (shobjidl_core.h)
Deletes a custom Jump List for a specified application.
Syntax
HRESULT DeleteList(
[in] LPCWSTR pszAppID
);
Parameters
[in] pszAppID
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.
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Target Platform | Windows |
| Header | shobjidl_core.h (include Shobjidl.h) |
| Library | Shell32.lib |
| DLL | Shell32.dll (version 6.1 or later) |
See also
Application User Model IDs (AppUserModelIDs)