> ## 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

Registra una devolución de llamada para los eventos de activación.

## Sintaxis

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

### Parámetros

*queue*   \_In\_opt\_\
Tipo: XTaskQueueHandle

La cola de tareas que distribuye la devolución de llamada del evento.

*context*   \_In\_opt\_\
Tipo: void\*

El contexto pasado a la devolución de llamada del evento.

*callback*   \_In\_\
Tipo: [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback)\*

La función de devolución de llamada del evento.

*token*   \_Out\_\
Tipo: [XTaskQueueRegistrationToken\*](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

Un token de la cola de tareas que representa el registro. Use el token para anular el registro de la devolución de llamada para los eventos de activación.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.\
Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

La función **XGameActivationRegisterForEvent** usa una [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback) como argumento. La devolución de llamada recibe una estructura [XGameActivationInfo](/reference/system/xgameactivation/structs/xgameactivationinfo) que contiene el tipo de activación y los datos correspondientes.

Esta API controla todos los tipos de activación, incluida la activación de protocolo, la activación de archivos y las invitaciones de juego. Reemplaza a las API en desuso `XGameProtocolRegisterForActivation` y `XGameInviteRegisterForEvent`.

Para anular el registro de una devolución de llamada para los eventos de activación, llame a [XGameActivationUnregisterForEvent](/reference/system/xgameactivation/functions/xgameactivationunregisterforevent).

Para ver un ejemplo de llamada a esta función, consulte la sección de comentarios del tema [XGameActivationCallback](/reference/system/xgameactivation/functions/xgameactivationcallback#remarks).

## Requisitos

**Encabezado:** XGameActivation.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Activación por tipo de archivo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Recepción de invitaciones](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Consulte también

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

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

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


## Related topics

- [XGameActivation](/es/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationUnregisterForEvent](/es/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)
- [XGameActivationCallback](/es/reference/system/xgameactivation/functions/xgameactivationcallback.md)
- [XGameProtocolRegisterForActivation (en desuso)](/es/reference/system/xgameprotocol/functions/xgameprotocolregisterforactivation.md)
- [Recepción de invitaciones](/es/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)