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

# XGameProtocolRegisterForActivation (déprécié)

> XGameProtocolRegisterForActivation (déprécié)

# XGameProtocolRegisterForActivation (déprécié)

> [!NOTE]
>
> Cette API est désormais dépréciée. Utilisez plutôt [XGameActivationRegisterForEvent](https://docs.xbox.com/fr/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md).

Inscrit un rappel pour l'activation de protocole.

## Syntaxe

```cpp theme={null}
STDAPI XGameProtocolRegisterForActivation(
    _In_opt_ XTaskQueueHandle queue,
    _In_opt_ void* context,
    _In_ XGameProtocolActivationCallback * callback,
    _Out_ XTaskQueueRegistrationToken* token
    ) noexcept;
```

### 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 : XGameProtocolActivationCallback\*

Fonction de rappel d'événement.

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

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

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

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

La fonction **XGameProtocolRegisterForActivation** prend comme argument un
[XGameProtocolActivationCallback](https://docs.xbox.com/fr/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md).

Pour désinscrire un rappel pour un événement d'invitation
de jeu, appelez [XGameProtocolUnregisterForEvent](https://docs.xbox.com/fr/reference/system/xgameprotocol/functions/xgameprotocolunregisterforactivation.md).

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Voir aussi

[Membres de XGameProtocol](https://docs.xbox.com/fr/reference/system/xgameprotocol/xgameprotocol_members.md)


## Related topics

- [XGameProtocolActivationCallbackXGameProtocol (déprécié)](https://docs.xbox.com/fr/reference/system/xgameprotocol/functions/xgameprotocolactivationcallback.md)
- [XGameProtocolUnregisterForActivation (déprécié)](https://docs.xbox.com/fr/reference/system/xgameprotocol/functions/xgameprotocolunregisterforactivation.md)
- [XGameProtocol (déprécié)](https://docs.xbox.com/fr/reference/system/xgameprotocol/xgameprotocol_members.md)
- [XGameActivation (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameActivationRegisterForEvent](https://docs.xbox.com/fr/reference/system/xgameactivation/functions/xgameactivationregisterforevent.md)