> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingUnregisterConnectivityHintChanged

> XNetworkingUnregisterConnectivityHintChanged

# XNetworkingUnregisterConnectivityHintChanged

Anula el registro de una función de devolución de llamada que se registró con [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md).

## Sintaxis

```cpp theme={null}
bool XNetworkingUnregisterConnectivityHintChanged(
         XTaskQueueRegistrationToken token,
         bool wait
)
```

### Parámetros

*token*   \_In\_\
Tipo: [XTaskQueueRegistrationToken](https://docs.xbox.com/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)

Token devuelto por [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md).

*wait*   \_In\_\
Tipo: bool

Indica si se debe bloquear hasta que se completen las devoluciones de llamada pendientes.

### Valor devuelto

Tipo: bool

Devuelve false si *wait* es false y la llamada de anulación del registro está pendiente. Devuelve true en caso contrario.

## Comentarios

> [!NOTE]
>
> No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

Esta función realiza las acciones siguientes:

* La devolución de llamada asociada al token se quita del conjunto de devoluciones de llamada registradas.
* Si no se está ejecutando ninguna devolución de llamada para ese token de devolución de llamada, la llamada devuelve true.
* Si se están ejecutando devoluciones de llamada y *wait* es true, la llamada se bloquea hasta que la devolución de llamada en ejecución haya finalizado.
* Si se están ejecutando devoluciones de llamada y *wait* es false, la llamada no se bloquea pero devuelve false. Cuando la devolución de llamada del token se completa, el registro del token se anula automáticamente.

> [!NOTE]
>
> No se debe llamar a esta función desde dentro de una [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md) si *wait* es true, ya que esto provocará un interbloqueo.

Este mecanismo permite los siguientes patrones de codificación:

* Puede bloquearse en la anulación del registro para asegurarse de que sus devoluciones de llamada nunca se invoquen después de una llamada de anulación del registro.
* Puede optar por no bloquearse. Si necesita asegurarse de que sus devoluciones de llamada se completen antes de eliminar datos, puede llamar periódicamente a esta función con *wait* establecido en false. Cuando finalmente devuelva true, todas sus devoluciones de llamada se habrán completado y podrá eliminar el estado.
* Si a su devolución de llamada no le importa si se invoca durante una llamada de anulación del registro, puede pasar false para *wait* y omitir el valor devuelto.

## Requisitos

**Encabezado:** XNetworking.h

**Biblioteca:** xgameruntime.lib

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

## Documentación conceptual

* [Subprocesos con restricciones de tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Consulte también

[XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)\
[XNetworkingGetConnectivityHint](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)\
[Inicialización de red y conectividad](https://docs.xbox.com/es/build/console-features/networking/initialization-connectivity-networking.md)\
[XNetworking](https://docs.xbox.com/es/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](https://docs.xbox.com/es/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [Detección del estado de inicialización de la red](https://docs.xbox.com/es/build/console-features/networking/initialization-connectivity-networking.md)
- [XTaskQueueRegistrationToken](https://docs.xbox.com/es/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)
