> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameActivationRegisterForEvent

> XGameActivationRegisterForEvent

# XGameActivationRegisterForEvent

注册激活事件的回调。

## Syntax

```cpp theme={null}
HRESULT XGameActivationRegisterForEvent(  
         XTaskQueueHandle queue,  
         void* context,  
         XGameActivationCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### Parameters

*queue*   \_In\_opt\_\
类型：XTaskQueueHandle

用于调度事件回调的任务队列。

*context*   \_In\_opt\_\
类型：void\*

传递给事件回调的上下文。

*callback*   \_In\_\
类型：[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)\*

事件回调函数。

*token*   \_Out\_\
类型：[XTaskQueueRegistrationToken\*](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

来自任务队列的令牌，表示此次注册。使用该令牌取消注册激活事件的回调。

### Return value

类型：HRESULT

HRESULT 成功或错误代码。
有关错误代码的列表，请参阅[错误代码](/reference/errorcodes)。

## Remarks

<Note>此函数在时间敏感型线程上调用是不安全的。有关详细信息，请参阅[时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

**XGameActivationRegisterForEvent** 函数使用 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback) 作为参数。回调接收包含激活类型和相应数据的 [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) 结构。

此 API 处理所有激活类型，包括协议激活、文件激活和游戏邀请。它替代了已弃用的 `XGameProtocolRegisterForActivation` 和 `XGameInviteRegisterForEvent` API。

若要取消注册激活事件的回调，请调用 [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)。

有关调用此函数的示例，请参阅 [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback#remarks) 主题的“备注”部分。

## Requirements

**头文件：** XGameActivation.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [文件类型激活](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## See also

[XGameActivation](/reference/system/xgameactivation/xgameactivation_members)

[XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)

[XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)


## Related topics

- [XGameActivation](/zh-CN/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationUnregisterForEvent](/zh-CN/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)
- [XGameProtocolRegisterForActivation (deprecated)](/zh-CN/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation.md)
- [XGameActivationCallback](/zh-CN/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [接收邀请](/zh-CN/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)