IStartMenuPinnedList interface
Exposes a method that unpins an application shortcut from the Start menu or the taskbar.
Members
The IStartMenuPinnedList interface inherits from the IUnknown interface. IStartMenuPinnedList also has these types of members:
Methods
The IStartMenuPinnedList interface has these methods.
| Method | Description |
|---|---|
| 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. Windows 7: Removes an item from the Start menu pinned list and unpins the item from the taskbar. Windows 8: Unpins the item from the taskbar but does not remove the item from the Start screen. |
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
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
DLL |
|