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

# XNetworkingRegisterConnectivityHintChanged

> XNetworkingRegisterConnectivityHintChanged

# XNetworkingRegisterConnectivityHintChanged

Inscrit le titre aux changements des informations à l'échelle de l'appareil sur le niveau de connectivité réseau actuel, les limites de données, le type d'interface et l'état d'initialisation du réseau.

## Syntaxe

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

### Paramètres

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

File d'attente dans laquelle placer le rappel lorsque l'indication de connectivité change.

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

Pointeur de contexte facultatif à passer au rappel.

*callback*   \_In\_\
Type : XNetworkingConnectivityHintChangedCallback\*

Fonction à appeler lorsque l'indication de connectivité change.

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

Jeton utilisé pour identifier le rappel lors de la désinscription.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Cette fonction inscrit une notification « indication de connectivité modifiée » et envoie un rappel de notification initial.

Pour désinscrire un rappel, utilisez [XNetworkingUnregisterConnectivityHintChanged](/fr/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged).

Les champs de la structure `XNetworkingConnectivityHint` renvoyée (à l'exception du champ `XNetworkingConnectivityHint::networkInitialized`) sont des indications. Il s'agit d'estimations au mieux effectuées par l'appareil sur l'état actuel du réseau, basées sur un résumé du trafic réseau de l'appareil. Il est important de noter que ces champs n'indiquent pas s'il existe une connectivité vers les points de terminaison spécifiques de votre titre. Nous vous recommandons, après avoir attendu l'initialisation du réseau, d'utiliser WinSock et/ou WinHTTP pour tenter d'établir une connexion à votre point de terminaison, quel que soit l'état du champ `XNetworkingConnectivityHint::connectivityLevelHint`. Si ces API échouent ensuite, nous vous recommandons d'utiliser l'API `XNetworkingGetConnectivityHint` à des fins supplémentaires d'interface utilisateur et de rapports de diagnostic. Vous devez ensuite attendre un changement du niveau de connectivité réseau avant de réessayer.

Pour plus d'informations sur l'initialisation du réseau, consultez [Initialisation et connectivité réseau](/fr/build/console-features/networking/initialization-connectivity-networking).

Cette méthode interroge l'état local au sein du processus appelant et retourne rapidement ; elle peut donc être appelée en toute sécurité depuis des contextes où le temps est critique.

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Voir aussi

[XNetworkingGetConnectivityHint](/fr/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingUnregisterConnectivityHintChanged](/fr/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/fr/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)