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

# XNetworkingConnectivityHint

> XNetworkingConnectivityHint

# XNetworkingConnectivityHint

Définit l'état actuel du réseau à l'échelle de l'appareil, y compris le niveau de connectivité réseau, les limites de données, le type d'interface et l'état d'initialisation du réseau.

## Syntaxe

```cpp theme={null}
typedef struct XNetworkingConnectivityHint {
    XNetworkingConnectivityLevelHint connectivityLevel;
    XNetworkingConnectivityCostHint connectivityCost;
    uint32_t ianaInterfaceType;
    bool networkInitialized;
    bool approachingDataLimit;
    bool overDataLimit;
    bool roaming;
} XNetworkingConnectivityHint
```

### Membres

*connectivityLevel*<br />Type : [XNetworkingConnectivityLevelHint](/fr/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint)

Niveau de connectivité actuel de l'appareil, estimé au mieux.

*connectivityCost*<br />Type : [XNetworkingConnectivityCostHint](/fr/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint)

Classification actuelle des limites de données de l'appareil, estimée au mieux.

*ianaInterfaceType*<br />Type : uint32\_t

Type d'interface actuel susceptible d'être utilisé par WinSock et WinHTTP pour accéder à Internet. Il s'agit de l'un des [types d'interfaces NDIS IANA](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types).

*networkInitialized*<br />Type : bool

Détermine si le réseau est actuellement initialisé. Pour plus d'informations, consultez la section [Initialisation du réseau](/fr/build/console-features/networking/initialization-connectivity-networking) de [Récupération des informations réseau](/fr/build/console-features/networking/initialization-connectivity-networking).

*approachingDataLimit*<br />Type : bool

Détermine si l'appareil est sur le point de dépasser ses limites de données.

*overDataLimit*<br />Type : bool

Détermine si l'appareil a dépassé ses limites de données.

*roaming*<br />Type : bool

Détermine si l'appareil est en itinérance ou non.

## Remarques

Assurez-vous que le membre *networkInitialized* renvoie true avant d'essayer d'utiliser des API réseau ou de sécurité.

<Note>
  Toute tentative d'utilisation des API XNetworking avec un réseau non initialisé entraînera des échecs d'appels et un comportement imprévisible.
</Note>

Cette structure est renvoyée par l'API [XNetworkingGetConnectivityHint](/fr/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint) et par le rappel du flux d'inscription. Pour obtenir des informations sur le réseau dans les titres Microsoft Game Development Kit (GDK), consultez [Récupération des informations réseau](/fr/build/console-features/networking/initialization-connectivity-networking).

Les champs de la structure `XNetworkingConnectivityHint` renvoyée (à l'exception du champ `XNetworkingConnectivityHint::networkInitialized`) sont des indications. Il s'agit d'estimations faites au mieux par l'appareil sur l'état actuel du réseau, à partir d'une synthèse 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 une modification du niveau de connectivité réseau avant de réessayer.

## Configuration requise

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

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

## Voir aussi

[XNetworking](/fr/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)