Retrieves an object that represents the collection of destinations listed in the Recent or Frequent category in a Jump List.
HRESULT GetList( APPDOCLISTTYPE listtype, UINT cItemsDesired, REFIID riid, void **ppv );
One of the following values that specifies from which category the list of destinations should be retrieved.
0x0. The Recent category, which lists those items most recently accessed.
0x1. The Frequent category, which lists the items that have been accessed the greatest number of times.
The number of items to retrieve from the list specified in listtype. Set this parameter to 0 to retrieve the full list.
A reference to the IID of the interface to retrieve through ppv, typically IID_IObjectArray or IID_IEnumObjects.
When this method returns, contains the interface pointer requested in riid. This is typically an IObjectArray or IEnumObjects which represents a collection of IShellItem or IShellLink objects (or a mix of the two) that represent the retrieved items from the list.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
An item can appear in both the Recent and Frequent lists.
If a user pins an item in the Recent or Frequent categories, the item is no longer shown in its original category to avoid duplication in the Jump List. However, the item will still be returned by this method.
|Minimum supported client||Windows 7 [desktop apps only]|
|Minimum supported server||Windows Server 2008 R2 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|
|DLL||Shell32.dll (version 6.1 or later)|