> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationcallback.md)\*

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

*token*   \_Out\_\
Tipo: [XTaskQueueRegistrationToken\*](https://docs.xbox.com/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

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](https://docs.xbox.com/es/reference/errorcodes.md).

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

La función **XGameActivationRegisterForEvent** usa una [XGameActivationCallback](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationcallback.md) como argumento. La devolución de llamada recibe una estructura [XGameActivationInfo](https://docs.xbox.com/es/reference/system/xgameactivation/structs/xgameactivationinfo.md) 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](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md).

Para ver un ejemplo de llamada a esta función, consulte la sección de comentarios del tema [XGameActivationCallback](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationcallback.md#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](https://docs.xbox.com/es/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)

## Consulte también

[XGameActivation](https://docs.xbox.com/es/reference/system/xgameactivation/xgameactivation_members.md)

[XGameActivationCallback](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationcallback.md)

[XGameActivationUnregisterForEvent](https://docs.xbox.com/es/reference/system/xgameactivation/functions/xgameactivationunregisterforevent.md)


## Related topics

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