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

Cancela o registro de uma função de retorno de chamada que foi registrada com [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md).

## Sintaxe

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

### Parâmetros

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

O token retornado por [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md).

*wait*   \_In\_\
Tipo: bool

Indica se deve bloquear até que todos os retornos de chamada pendentes sejam concluídos.

### Valor retornado

Tipo: bool

Retorna false se *wait* for false e a chamada de cancelamento de registro estiver pendente. Caso contrário, retorna true.

## Comentários

> [!NOTE]
>
> Não é seguro chamar essa função em um thread sensível ao tempo. Para obter mais informações, confira [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

Essa função executa as seguintes ações:

* O retorno de chamada associado ao token é removido do conjunto de retornos de chamada registrados.
* Se nenhum retorno de chamada estiver em execução para esse token de retorno de chamada, a chamada retornará true.
* Se houver retornos de chamada em execução e *wait* for true, a chamada será bloqueada até que o retorno de chamada em execução seja concluído.
* Se houver retornos de chamada em execução e *wait* for false, a chamada não será bloqueada, mas retornará false. Quando o retorno de chamada do token for concluído, o registro do token será cancelado automaticamente.

> [!NOTE]
>
> Essa função não deve ser chamada de dentro de um [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md) se *wait* for true, pois isso causará um deadlock.

Esse mecanismo permite os seguintes padrões de codificação:

* Você pode bloquear o cancelamento do registro para garantir que seus retornos de chamada nunca sejam invocados após uma chamada de cancelamento de registro.
* Você pode optar por não bloquear. Se precisar garantir que seus retornos de chamada sejam concluídos antes de excluir dados, você poderá chamar essa função periodicamente com *wait* definido como false. Quando ela finalmente retornar true, todos os seus retornos de chamada estarão concluídos e você poderá excluir o estado.
* Se não importar para o seu retorno de chamada se ele está sendo invocado durante uma chamada de cancelamento de registro, você poderá passar false para *wait* e ignorar o valor retornado.

## Requisitos

**Cabeçalho:** XNetworking.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)\
[XNetworkingGetConnectivityHint](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)\
[Inicialização e conectividade de rede](https://docs.xbox.com/pt-BR/build/console-features/networking/initialization-connectivity-networking.md)\
[XNetworking](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [Detectar o status de inicialização da rede](https://docs.xbox.com/pt-BR/build/console-features/networking/initialization-connectivity-networking.md)
- [XTaskQueueRegistrationToken](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken.md)