GetCurrentProcessExplicitAppUserModelID 函数 (shobjidl_core.h)

检索当前进程的应用程序定义的显式应用程序用户模型 ID (AppUserModelID) 。

语法

SHSTDAPI GetCurrentProcessExplicitAppUserModelID(
  [out] PWSTR *AppID
);

参数

[out] AppID

类型: PWSTR*

一个指针,用于接收分配给进程的 AppUserModelID 的地址。 调用方负责在不再需要时通过 CoTaskMemFree 释放此字符串。

返回值

类型: HRESULT

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

注解

此函数检索到的 AppUserModelID 先前是通过 SetCurrentProcessExplicitAppUserModelID 设置的

应用程序只能检索已显式设置的 AppUserModelID。 无法检索系统分配的默认 AppUserModelID。 如果应用程序需要了解其 AppUserModelID,则应显式设置一个。

要求

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

另请参阅

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

IObjectWithAppUserModelID::GetAppID

任务栏扩展