IStartMenuPinnedList interface (shobjidl.h)

Exposes a method that unpins an application shortcut from the Start menu or the taskbar.

Inheritance

The IStartMenuPinnedList interface inherits from the IUnknown interface. IStartMenuPinnedList also has these types of members:

Methods

The IStartMenuPinnedList interface has these methods.

IStartMenuPinnedList::RemoveFromList Windows Vista:_Removes an item from the Start menu pinned list, which is the list in the upper left position of the Start menu.

Remarks

When to Implement

Windows provides an implementation of this interface as CLSID_StartMenuPin. Third parties do not provide their own implementation.

When to Use

Any shortcut installed by an application might have been subsequently pinned by the user, and there is no way for an application to know this. Therefore, we recommend that, during uninstallation, all applications call IStartMenuPinnedList::RemoveFromList on each shortcut they installed.

Note that IStartMenuPinnedList does not remove the shortcuts themselves, it only unpins them. Applications first call IStartMenuPinnedList::RemoveFromList on a shortcut, then delete that shortcut.

Compatibility

In Windows 8, the Start screen replaces the legacy Start menu. CLSID_StartMenuPin and IStartMenuPinnedList are present in Windows 8 to provide backward compatibility with existing applications, but they do not affect tiles pinned to the Windows 8 Start screen. CLSID_StartMenuPin and IStartMenuPinnedList do continue to impact items pinned to the Windows 8 desktop taskbar.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl.h