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

# XNetworkingUnregisterConnectivityHintChanged

> XNetworkingUnregisterConnectivityHintChanged

# XNetworkingUnregisterConnectivityHintChanged

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

## Sintaxe

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

### Parâmetros

*token*   \_In\_\
Tipo: [XTaskQueueRegistrationToken](/pt-BR/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)

O token retornado por [XNetworkingRegisterConnectivityHintChanged](/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged).

*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).</Note>

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](/pt-BR/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback) se *wait* for true, pois isso causará um deadlock.</Note>

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](/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingGetConnectivityHint](/pt-BR/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[Inicialização e conectividade de rede](/pt-BR/build/console-features/networking/initialization-connectivity-networking)\
[XNetworking](/pt-BR/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)