IApplicationDestinations::RemoveDestination method (shobjidl_core.h)
Removes a single destination from the Recent and Frequent categories in a Jump List.
Syntax
HRESULT RemoveDestination(
[in] IUnknown *punk
);
Parameters
[in] punk
Type: IUnknown*
A pointer to the IShellItem or IShellLink that represents the destination to remove.
Return value
Type: HRESULT
Returns S_OK if successful, or a standard COM error value otherwise. If the object pointed to by punk is not an IShellItem or IShellLink, the method returns E_INVALIDARG.
Remarks
A destination can appear in both the Recent and Frequent categories. If that is the case, this method removes the destination from both categories.
If the item is pinned to the list by the user, it is not removed but its usage data is cleared.
An application can call RemoveDestination without knowing if the item pointed to by punk is currently in the list. If there is no existing data on the item (in which case it is not in the Recent or Frequent list), this method does nothing and returns S_OK.
If the application has an explicit Application User Model ID (AppUserModelID), you must call IApplicationDestinations::SetAppID before you call this method.
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
IApplicationDestinations::RemoveAllDestinations