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 |