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

# HCWebSocketRoutedHandler

> Rappel appelé de façon synchrone lorsque du trafic WebSocket est envoyé ou reçu, afin que vous puissiez déboguer ou tracer le trafic.

# HCWebSocketRoutedHandler

Rappel défini par l'application que libHttpClient appelle de façon synchrone lorsque du trafic WebSocket est envoyé ou reçu. Inscrivez-le avec [HCAddWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcaddwebsocketroutedhandler.md) pour déboguer ou tracer le trafic WebSocket.

## Syntaxe

```cpp theme={null}
void STDAPIVCALLTYPE HCWebSocketRoutedHandler(
         HCWebsocketHandle websocket,
         bool receiving,
         const char* message,
         const uint8_t* payloadBytes,
         size_t payloadSize,
         void* context
)
```

### Paramètres

*websocket*   \_In\_\
Type : HCWebsocketHandle

Le descripteur du WebSocket.

*receiving*   \_In\_\
Type : bool

`true` si les données sont reçues; `false` si elles sont envoyées.

*message*   \_In\_opt\_z\_\
Type : const char\*

Le message texte encodé en UTF-8, ou `nullptr` pour un message binaire.

*payloadBytes*   \_In\_opt\_\
Type : const uint8\_t\*

Les données du message binaire, ou `nullptr` pour un message texte.

*payloadSize*   \_In\_\
Type : size\_t

La taille de *payloadBytes*, en octets.

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

Le contexte client que vous avez passé à [HCAddWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcaddwebsocketroutedhandler.md).

### Valeur de retour

Type : void

## Remarques

*message* ou *payloadBytes* est non nul, selon que le message est de type texte ou binaire.

Le gestionnaire s'exécute de façon synchrone, en ligne avec le trafic WebSocket. Gardez-le court et n'y effectuez aucune opération bloquante.

Pour ne plus recevoir d'appels, passez l'ID retourné par `HCAddWebSocketRoutedHandler` à [HCRemoveWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcremovewebsocketroutedhandler.md).

## Configuration requise

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

**Bibliothèque :** libHttpClient.lib

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

## Voir aussi

[httpClient](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/httpclient_members.md)\
[HCAddWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcaddwebsocketroutedhandler.md)\
[HCRemoveWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcremovewebsocketroutedhandler.md)


## Related topics

- [HCAddWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcaddwebsocketroutedhandler.md)
- [HCRemoveWebSocketRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcremovewebsocketroutedhandler.md)
- [httpClient (contenu)](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/httpclient_members.md)
- [XblCallRoutedHandler](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/xbox_live_global_c/functions/xblcallroutedhandler.md)
- [HCWebSocketCreate](https://docs.xbox.com/fr-CA/reference/live/httpclient/httpclient/functions/hcwebsocketcreate.md)