Поделиться через


Интерфейс IApplicationDestinations (shobjidl_core.h)

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

Наследование

Интерфейс IApplicationDestinations наследуется от интерфейса IUnknown . IApplicationDestinations также имеет следующие типы элементов:

Методы

Интерфейс IApplicationDestinations содержит следующие методы.

 
IApplicationDestinations::RemoveAllDestinations

Удаляет все целевые записи из категорий Последние и Частые в списке переходов приложения.
IApplicationDestinations::RemoveDestination

Удаляет одно назначение из категорий Последние и Частые в списке переходов.
IApplicationDestinations::SetAppID

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

Комментарии

Когда следует реализовать

Реализация этого интерфейса предоставляется в Windows как CLSID_ApplicationDestinations. Этот интерфейс не реализуется третьими лицами.

Когда следует использовать

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

Приложение должно вызывать методы IApplicationDestinations в следующих ситуациях:

  • При удалении приложения.
  • Когда пользователь очищает журнал.
  • Когда пользователь отключает отслеживание назначения на страницах параметров или параметров приложения.
  • Когда пользователь удаляет назначение из приложения. Это особенно важно в случае назначения, которое не является файлом. В случае назначений, не относящихся к файлам ( как правило, хотя и не всегда, элементов IShellLink ), приложение несет ответственность за удаление назначения из списка, когда оно обнаруживает, что оно больше не существует.

Если пользователь отключает отслеживание использования в параметре конфиденциальности приложения, приложение несет ответственность за очистку существующих данных, а также за то, чтобы система не собирала данные об использовании этого элемента в будущем. Для этого необходимо задать значение NoRecentDocs во всех регистрациях типов файлов приложения. Дополнительные сведения см. в разделе FTA_NoRecentDocs .

Методы IApplicationDestinations используются только с автоматически созданными категориями Recent или Frequent. Они не удаляют элементы, закрепленные пользователем в списке переходов. Эти элементы нельзя удалить программными средствами; Удалить их может только пользователь. Эти методы также не влияют на пользовательские категории или список задач.

Требования

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

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

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