IApplicationDocumentLists::SetAppID 方法 (shobjidl_core.h)
为要检索其目标列表的应用程序指定唯一的应用程序用户模型 ID (AppUserModelID) 。 此方法是可选的。
语法
HRESULT SetAppID(
[in] LPCWSTR pszAppID
);
参数
[in] pszAppID
类型: LPCWSTR
指向其任务栏按钮表示形式接收跳转列表的进程 AppUserModelID 的指针。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
如果应用程序具有显式 AppUserModelID,则必须在调用 GetList 之前调用此方法。
通过对象的 SetAppID 方法指定 AppUserModelID 后,AppUserModelID 将保存在对象的生存期内,前提是该对象的另一次调用不会覆盖该 对象。
某些应用程序不会声明显式 AppUserModelID,并且不应调用此方法。 在这种情况下,调用 IApplicationDocumentLists::GetList 时会推断出应用程序的标识。 但是,避免这些计算具有性能优势,因此建议提供自定义跳转列表的应用程序使用 显式 AppUserModelID。
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
Library | Shell32.lib |
DLL | Shell32.dll (6.1 或更高版本) |