ICustomDestinationList::D eleteList 方法 (shobjidl_core.h)

删除指定应用程序的自定义跳转列表。

语法

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

参数

[in] pszAppID

类型: LPCWSTR

指向进程的 AppUserModelID 的指针,其任务栏按钮表示形式显示自定义跳转列表。 在 Windows 7 的 beta 版本中,必须显式提供此 AppUserModelID,因为此方法旨在从卸载程序调用,卸载程序在单独的进程中运行。 由于它位于单独的进程中,因此系统无法可靠地推断 AppUserModelID。 预计在以后的版本中将删除此限制。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

在多个情况下,应调用此方法,包括:

  • 卸载应用程序时。
  • 当用户从应用程序内清除历史记录时。
  • 当用户在应用程序的“设置”或“选项”页中禁用目标跟踪时。
当应用程序更新自定义目标列表时,不应调用此方法。 它仅用于在卸载操作期间完全清除列表,或者应用程序为用户提供了关闭列表的选项。

删除自定义跳转列表后,将显示从系统生成的数据中为最近使用的项生成的标准跳转列表。 如果未收集此类数据,或者通过 RemoveAllDestinations 清除了信息,则跳转列表可能仅包含其最小且始终存在的内容:要固定或取消固定的标准任务、启动应用程序的新实例或关闭窗口。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll (6.1 或更高版本)

另请参阅

应用程序用户模型 ID (AppUserModelIDs)

ICustomDestinationList

ICustomDestinationList::SetAppID

任务栏扩展