Метод IApplicationDocumentLists::GetList (shobjidl_core.h)

Статья
08/26/2023

Извлекает объект , представляющий коллекцию назначений, перечисленных в категории Последние или Частые в списке переходов.

Синтаксис

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

Параметры

[in] listtype

Тип: APPDOCLISTTYPE

Одно из следующих значений, указывающее, из какой категории следует извлечь список назначений.

ADLT_RECENT (0x0)

0x0. Категория Последние , в которой перечислены последние элементы, к которым был доступ.

ADLT_FREQUENT (0x1)

0x1. Категория "Часто ", в которой перечислены элементы, к которым обращались наибольшее количество раз.

[in] cItemsDesired

Тип: UINT

Количество элементов, извлекаемых из списка, указанного в типе списка. Задайте для этого параметра значение 0, чтобы получить полный список.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_IObjectArray или IID_IEnumObjects.

[out] ppv

Тип: void**

При возврате этим методом содержит указатель интерфейса, запрошенный в riid. Обычно это IObjectArray или IEnumObjects , представляющий коллекцию объектов IShellItem или IShellLink (или сочетание двух), представляющих элементы, полученные из списка.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Если пользователь закрепляет элемент в категориях Последние или Частые , элемент больше не отображается в исходной категории, чтобы избежать дублирования в списке переходов. Однако элемент по-прежнему будет возвращен этим методом.

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 6.1 или более поздняя)