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

Define el estado actual de la red en todo el dispositivo, incluidos el nivel de conectividad de red, los límites de datos, el tipo de interfaz y el estado de inicialización de la red.

## Sintaxis

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

### Miembros

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

Nivel de conectividad actual de mejor esfuerzo del dispositivo.

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

Clasificación actual de mejor esfuerzo de los límites de datos del dispositivo.

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

Tipo de interfaz actual que probablemente usarán WinSock y WinHTTP para acceder a Internet.  Uno de los [tipos de interfaz NDIS de IANA](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types).

*networkInitialized*<br />Tipo: bool

Determina si la red está inicializada actualmente.  Para obtener más información, consulte la sección [Inicialización de red](/build/console-features/networking/initialization-connectivity-networking) de [Recuperación de información de red](/build/console-features/networking/initialization-connectivity-networking).

*approachingDataLimit*<br />Tipo: bool

Determina si el dispositivo está a punto de superar sus límites de datos.

*overDataLimit*<br />Tipo: bool

Determina si el dispositivo ha superado sus límites de datos.

*roaming*<br />Tipo: bool

Determina si el dispositivo está en itinerancia o no.

## Comentarios

Asegúrese de que el miembro *networkInitialized* devuelva true antes de intentar usar cualquier API de red o de seguridad.

<Note>
  Intentar usar las API de XNetworking con una red que no está inicializada dará lugar a llamadas con error y a un comportamiento impredecible.
</Note>

Esta estructura se devuelve desde la API [XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint) y desde la devolución de llamada del flujo de registro. Para obtener información de red en títulos de Microsoft Game Development Kit (GDK), consulte [Recuperación de información de red](/build/console-features/networking/initialization-connectivity-networking).

Los campos de la estructura `XNetworkingConnectivityHint` devuelta (excepto el campo `XNetworkingConnectivityHint::networkInitialized`) son sugerencias. Son estimaciones de mejor esfuerzo realizadas por el dispositivo sobre el estado actual de la red basadas en un resumen del tráfico de red en el dispositivo. Es importante destacar que estos campos no representan si hay conectividad con los puntos de conexión específicos de su título. Se recomienda que, después de esperar a la inicialización de la red, use WinSock o WinHTTP para intentar establecer una conexión con su punto de conexión independientemente del estado del campo `XNetworkingConnectivityHint::connectivityLevelHint`. Si esas API fallan posteriormente, se recomienda usar entonces la API `XNetworkingGetConnectivityHint` con fines adicionales de interfaz de usuario e informes de diagnóstico. Después, debe esperar a un cambio en el nivel de conectividad de red antes de volver a intentarlo.

## Requisitos

**Encabezado:** XNetworking.h

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](/es/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityLevelHint](/es/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)
- [XNetworkingConnectivityCostHint](/es/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)
- [XNetworkingRegisterConnectivityHintChanged](/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)