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

# XNetworkingGetConnectivityHint

> XNetworkingGetConnectivityHint

# XNetworkingGetConnectivityHint

Consulta información de todo el dispositivo sobre el nivel actual 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}
HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)
```

### Parámetros

*connectivityHint*   \_Out\_<br />Tipo: [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

El estado actual de la red en todo el dispositivo.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

Esta función devuelve información de todo el dispositivo sobre el nivel de conectividad de red, los límites de datos, la conectividad por cable frente a inalámbrica y si la red está inicializada. Puede escuchar los cambios con las funciones [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) y [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged).

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 del dispositivo. Es importante señalar 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 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 que se produzca un cambio en el nivel de conectividad de red antes de volver a intentarlo.

Para obtener más información sobre la inicialización de la red, consulte [Inicialización y conectividad de red](/build/console-features/networking/initialization-connectivity-networking).

Este método consulta el estado local dentro del proceso que realiza la llamada y devuelve rápidamente, por lo que es seguro llamarlo desde contextos con restricciones de tiempo.

## Requisitos

**Encabezado:** XNetworking.h

**Biblioteca:** xgameruntime.lib

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

## Consulte también

[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)<br />[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)<br />[Detección del estado de inicialización de la red](/build/console-features/networking/initialization-connectivity-networking)<br />[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/es/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHint](/es/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [Detección del estado de inicialización de la red](/es/build/console-features/networking/initialization-connectivity-networking.md)