IApplicationDestinations::RemoveAllDestinations method

Clears all destination entries from the Recent and Frequent categories in an application's Jump List.

Syntax


HRESULT RemoveAllDestinations();

Parameters

This method has no parameters.

Return value

Type: HRESULT

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

Remarks

This method does not remove items that the user has pinned to the Jump List. Those items cannot be removed programmatically; only the user can remove them. However, it does remove usage data for those pinned items. It also cannot remove items from custom categories or the task list.

If the application has an explicit Application User Model ID (AppUserModelID), you must call IApplicationDestinations::SetAppID before you call this method.

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

IApplicationDestinations
IApplicationDestinations::RemoveDestination
IApplicationDestinations::SetAppID
Taskbar Extensions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft