IApplicationDestinations 接口 (shobjidl_core.h)

公开允许应用程序从跳转列表中的 “最近” 或“ 常用 ”类别中删除一个或所有目标的方法。

继承

IApplicationDestinations 接口继承自 IUnknown 接口。 IApplicationDestinations 还具有以下类型的成员：

IApplicationDestinations 接口包含以下方法。


IApplicationDestinations：：RemoveAllDestinations 从应用程序的跳转列表中“最近”和“常用”类别中清除所有目标条目。
IApplicationDestinations：：RemoveDestination 从跳转列表中的“最近”和“常用”类别中删除单个目标。
IApplicationDestinations：：SetAppID 指定应用程序的唯一应用程序用户模型 ID (AppUserModelID) ，此接口的方法将从其任务栏按钮的跳转列表中删除目标。此方法是可选的。

此接口的实现在 Windows 中作为CLSID_ApplicationDestinations提供。此接口不由第三方实现。

当应用程序想要从跳转列表自动生成的目标中删除项时，它会调用此接口的方法。这些目标（位于 “最近” 或“ 常用 ”类别中）是通过调用 SHAddToRecentDocs 生成的，当通过 Windows 资源管理器打开文件或使用通用文件对话框打开、保存或创建文件时，由系统显式调用生成。

在以下情况下，应用程序应调用 IApplicationDestinations 方法：

卸载应用程序时。
当用户清除历史记录时。
当用户在应用程序的“设置”或“选项”页中禁用目标跟踪时。
当用户从应用程序中删除目标时。对于不是文件的目标，这一点尤其重要。对于非文件目标（通常（虽然并非总是是 IShellLink 项）而言，当检测到目标不再存在时，应用程序应负责从列表中删除该目标。

如果用户在应用程序的隐私设置中关闭使用情况跟踪，则应用程序负责清除现有数据，并阻止系统将来收集该项目的使用情况数据。这是通过在应用程序的所有文件类型注册中设置 NoRecentDocs 值来完成的。有关详细信息，请参阅FTA_NoRecentDocs 。

IApplicationDestinations 方法仅用于自动生成的“ 最近” 或“ 常用 ”类别。它们不会删除用户已固定到跳转列表的项目。无法以编程方式删除这些项;只有用户可以删除它们。这些方法也不会影响自定义类别或任务列表。