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

另请参阅

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

IApplicationDocumentLists

任务栏扩展