> ## 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-CA/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint)

Le niveau de connectivité actuel de l'appareil, déterminé au mieux.

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

La classification actuelle des limites de données de l'appareil, déterminée au mieux.

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

Le type d'interface actuel susceptible d'être utilisé par WinSock et WinHTTP pour atteindre Internet.  L'un des [types d'interface NDIS de l'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-CA/build/console-features/networking/initialization-connectivity-networking) de [Récupération des informations réseau](/fr-CA/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* retourne true avant de tenter d'utiliser des API de réseau ou de sécurité.

<Note>
  Tenter d'utiliser les API XNetworking avec un réseau qui n'est pas initialisé entraînera des échecs d'appels et un comportement imprévisible.
</Note>

Cette structure est retournée par l'API [XNetworkingGetConnectivityHint](/fr-CA/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-CA/build/console-features/networking/initialization-connectivity-networking).

Les champs de la structure `XNetworkingConnectivityHint` retournée (à l'exception du champ `XNetworkingConnectivityHint::networkInitialized`) sont des indications. Il s'agit d'estimations faites au mieux par l'appareil quant à l'état actuel du réseau, à partir d'un résumé du trafic réseau sur l'appareil. Il est important de noter que ces champs n'indiquent pas s'il existe une connectivité vers les points de terminaison propres à votre titre. Nous vous recommandons, après avoir attendu l'initialisation du réseau, d'utiliser WinSock ou WinHTTP (ou les deux) pour tenter d'établir une connexion à votre point de terminaison, quel que soit l'état du champ `XNetworkingConnectivityHint::connectivityLevelHint`. Si ces API échouent par la suite, nous vous recommandons d'utiliser alors 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.

## 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-CA/reference/networking/xnetworking/xnetworking_members)


## Related topics

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