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 或更高版本) |