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

Registra el título para recibir cambios en la 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 XNetworkingRegisterConnectivityHintChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingConnectivityHintChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### Parámetros

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

Cola en la que se coloca la devolución de llamada cuando cambia la sugerencia de conectividad.

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

Puntero de contexto opcional que se pasa a la devolución de llamada.

*callback*   \_In\_\
Tipo: XNetworkingConnectivityHintChangedCallback\*

Función a la que se llama cuando cambia la sugerencia de conectividad.

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

Token que se usa para identificar la devolución de llamada al anular el registro.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

Esta función registra una notificación de "sugerencia de conectividad cambiada" y envía una devolución de llamada de notificación inicial.

Para anular el registro de una devolución de llamada, use [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 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.

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

Este método consulta el estado local dentro del proceso que realiza la llamada y se 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

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


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/es/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/es/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingGetConnectivityHint](/es/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [Detección del estado de inicialización de la red](/es/build/console-features/networking/initialization-connectivity-networking.md)
- [XNetworking](/es/reference/networking/xnetworking/xnetworking_members.md)