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

Inscrit un rappel pour les événements d'activation.

## Syntaxe

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

### Paramètres

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

File d'attente de tâches qui distribue le rappel d'événement.

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

Contexte passé au rappel d'événement.

*callback*   \_In\_\
Type : [XGameActivationCallback](/fr-CA/reference/system/xgameactivation/functions/xgameactivationcallback)\*

Fonction de rappel d'événement.

*token*   \_Out\_\
Type : [XTaskQueueRegistrationToken\*](/fr-CA/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

Jeton de la file d'attente de tâches qui représente l'inscription. Utilisez ce jeton pour désinscrire le rappel pour les événements d'activation.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.\
Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

La fonction **XGameActivationRegisterForEvent** prend comme argument un [XGameActivationCallback](/fr-CA/reference/system/xgameactivation/functions/xgameactivationcallback). Le rappel reçoit une structure [XGameActivationInfo](/fr-CA/reference/system/xgameactivation/structs/xgameactivationinfo) qui contient le type d'activation et les données correspondantes.

Cette API gère tous les types d'activation, y compris l'activation de protocole, l'activation de fichier et les invitations de jeu. Elle remplace les API dépréciées `XGameProtocolRegisterForActivation` et `XGameInviteRegisterForEvent`.

Pour désinscrire un rappel pour les événements d'activation, appelez [XGameActivationUnregisterForEvent](/fr-CA/reference/system/xgameactivation/functions/xgameactivationunregisterforevent).

Pour obtenir un exemple d'appel de cette fonction, consultez la section Remarques de la rubrique [XGameActivationCallback](/fr-CA/reference/system/xgameactivation/functions/xgameactivationcallback#remarks).

## Configuration requise

**En-tête :** XGameActivation.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Activation par type de fichier](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/overviews/filetypeactivation)
* [Réception d'invitations](/fr-CA/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Voir aussi

[XGameActivation](/fr-CA/reference/system/xgameactivation/xgameactivation_members)

[XGameActivationCallback](/fr-CA/reference/system/xgameactivation/functions/xgameactivationcallback)

[XGameActivationUnregisterForEvent](/fr-CA/reference/system/xgameactivation/functions/xgameactivationunregisterforevent)


## Related topics

- [XGameActivationRegisterForEvent](/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)
- [XGameActivation](/reference/system/xgameactivation/xgameactivation_members.md)