INotificationActivationCallback::Activate 方法 (notificationactivationcallback.h)

当用户与操作中心中的 Toast 交互时调用。

语法

HRESULT Activate(
  [in] LPCWSTR                            appUserModelId,
  [in] LPCWSTR                            invokedArgs,
  [in] const NOTIFICATION_USER_INPUT_DATA *data,
  [in] ULONG                              count
);

参数

[in] appUserModelId

向通知平台表示应用的唯一标识符。

[in] invokedArgs

调用的按钮中的参数。 如果 Toast 指示默认激活,并且 XML 有效负载中未指定任何启动参数,则为 NULL

[in] data

来自通知 Toast 上可用的输入元素的数据。

[in] count

数据元素的数目。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

为了让应用在操作中心响应 Toast,需要在应用中替代此方法。 还需要在“开始”菜单上创建快捷方式。 有关如何响应激活通知的详细信息,请参阅 响应 Toast 激活

如果应用程序使用非交互式 Toast,则无需使用 invokedArgs数据即可响应这些 Toast。

如果返回失败代码,激活将失败,用户可以重试激活应用。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 notificationactivationcallback.h

另请参阅

INotificationActivationCallback

响应 Toast 激活