> ## 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/reference/system/xgameactivation/functions/xgameactivationcallback)\*

Fonction de rappel d'événement.

*token*   \_Out\_\
Type : [XTaskQueueRegistrationToken\*](/fr/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/reference/errorcodes).

## Remarques

<Note>Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](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/reference/system/xgameactivation/functions/xgameactivationcallback). Le rappel reçoit une structure [XGameActivationInfo](/fr/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, notamment 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/reference/system/xgameactivation/functions/xgameactivationunregisterforevent).

Pour obtenir un exemple d'appel de cette fonction, consultez la section Remarques de la rubrique [XGameActivationCallback](/fr/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/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Voir aussi

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

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

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


## Related topics

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