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

任务栏扩展