Метод ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)

Статья
08/26/2023

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

Синтаксис

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

Параметры

[in] riid

Тип: REFIID

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

[out] ppv

Тип: void**

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

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

Тип: HRESULT

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

Элементы можно удалить из пользовательского интерфейса списка переходов с помощью действия пользователя. Затем элемент помечается как удаленный и больше не отображается. Приложение может использовать этот метод, чтобы указать, какие элементы пользователь удалил, чтобы оно не отображало их в пользовательском списке. Например, этот метод следует вызывать при запуске приложения, если это приложение не собирается создавать новый список с помощью ICustomDestinationList::BeginList.

Настоятельно рекомендуется, чтобы приложение удалило все данные отслеживания назначения, когда пользователь решит удалить это назначение. Если пользователь снова перейдет к этому месту назначения в будущем, он может быть повторно добавлен в список переходов и снова накапливать данные. Тот же список удаленных назначений, полученный этим методом, извлекается при вызове метода ICustomDestinationList::BeginList . В этом случае приложение не должно немедленно пытаться повторно вставить любой удаленный элемент, иначе вызов AppendCategory завершится ошибкой . Это гарантирует, что приложение учитывает намерение пользователя удалить элемент.

Если приложение имеет явный идентификатор модели пользователя приложения (AppUserModelID), необходимо вызвать SetAppID перед вызовом этого метода.

Даже если приложение вызывает Метод GetRemovedDestinations и находит элемент в списке, который с высокой вероятностью будет восстановлен в списке переходов раньше, чем ожидается создание нового пользовательского списка переходов, приложение должно написать список переходов без этого элемента и повторно добавить его в список только после того, как пользователь снова получит к нему доступ.

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

Вызов Метода GetRemovedDestinations не очищает удаленные данные назначений. Эти данные необходимы BeginList для следующего создания списка. Удаленные данные назначений больше не требуются и очищаются после начала сеанса создания списка с помощью BeginList, продолжается без неудачных вызовов AppendCategory и завершается вызовом CommitList.

Требования

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

См. также раздел

ICustomDestinationList

ICustomDestinationList::BeginList

Расширения панели задач