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

# XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged

> XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged

# XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged

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

## Sintaxe

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

### Parâmetros

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

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

*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>É seguro chamar esta função em um thread sensível ao tempo somente se o parâmetro *wait* for false. 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>

Esta 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>Esta função não deve ser chamada de dentro de um [XNetworkingPreferredLocalUdpMultiplayerPortChangedCallback](/pt-BR/reference/networking/xnetworking/functions/xnetworkingpreferredlocaludpmultiplayerportchangedcallback) se *wait* for true, pois isso causará um deadlock.</Note>

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

* Você pode bloquear no cancelamento de 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 esta 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 compatíveis:** 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

[XNetworkingQueryPreferredLocalUdpMultiplayerPort](/pt-BR/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport)\
[APIs de rede da porta multijogador UDP local preferencial](/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)\
[XNetworking](/pt-BR/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)
- [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md)