IApplicationDocumentLists：：GetList 方法 (shobjidl_core.h)

检索一个对象，该对象表示跳转列表中的“ 最近” 或“ 常用 ”类别中列出的目标集合。

语法

HRESULT GetList(
  [in]  APPDOCLISTTYPE listtype,
  [in]  UINT           cItemsDesired,
  [in]  REFIID         riid,
  [out] void           **ppv
);

[in] listtype

类型： APPDOCLISTTYPE

以下值之一，指定应从哪个类别检索目标列表。

0x0。 “ 最近” 类别，其中列出了最近访问的项。

0x1。 “频繁”类别，其中列出了访问次数最多的项。

[in] cItemsDesired

类型： UINT

要从 listtype 中指定的列表中检索的项数。将此参数设置为 0 可检索完整列表。

[in] riid

类型： REFIID

对要通过 ppv 检索的接口的 IID 的引用，通常IID_IObjectArray或IID_IEnumObjects。

[out] ppv

类型： void**

此方法返回时，包含 riid 中请求的接口指针。这通常是一个 IObjectArray 或 IEnumObjects ，它表示 (IShellItem 或 IShellLink 对象的集合，或者表示从列表中检索到的项的两个) 的混合。

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

项目可以同时显示在“ 最近 ”和“ 常用 ”列表中。

如果用户将某个项目固定在 “最近” 或“ 常用 ”类别中，该项目将不再显示在其原始类别中，以避免跳转列表中的重复。但是，此方法仍会返回该项。