IApplicationDestinations：：RemoveDestination 方法 (shobjidl_core.h)

从跳转列表中的 “最近” 和“ 常用 ”类别中删除单个目标。

语法

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

[in] punk

类型： IUnknown*

指向 IShellItem 或 IShellLink 的指针，表示要删除的目标。

类型： HRESULT

如果成功，则返回S_OK，否则返回标准 COM 错误值。如果 punk 指向的对象不是 IShellItem 或 IShellLink，则该方法返回E_INVALIDARG。

目标可以同时显示在 “最近 ”和“ 频繁” 类别中。如果是这种情况，此方法将从这两个类别中删除目标。

如果用户将该项固定到列表中，则不会删除该项，但会清除其使用情况数据。

应用程序可以调用 RemoveDestination ，而无需知道朋克指向的项当前是否在列表中。如果项 (没有现有数据，在这种情况下，它不在 “最近” 或“ 频繁 ”列表) ，则此方法不执行任何操作，并返回S_OK。

如果应用程序具有显式应用程序用户模型 ID (AppUserModelID) ，则必须在调用此方法之前调用 IApplicationDestinations：：SetAppID 。