SetCurrentProcessExplicitAppUserModelID 函数 (shobjidl_core.h)

  • 项目

指定应用程序定义的唯一应用程序用户模型 ID (AppUserModelID) ，用于标识任务栏的当前进程。 此标识符允许应用程序将其关联的进程和窗口分组到单个任务栏按钮下。

语法

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

参数

[in] AppID

类型： PCWSTR

指向要分配给当前进程的 AppUserModelID 的指针。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

必须先在应用程序的初始启动例程中调用此方法，然后应用程序才会显示任何 UI 或对其 Jump Lists进行任何操作。 这包括对 SHAddToRecentDocs 的任何调用。

要求

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

另请参阅

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

GetCurrentProcessExplicitAppUserModelID

任务栏扩展