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

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

> XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync

Obtém de forma assíncrona a porta UDP local preferencial a ser usada para o tráfego multijogador.

## Sintaxe

```cpp theme={null}
HRESULT XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync(
         XAsyncBlock* asyncBlock
)
```

### Parâmetros

*asyncBlock*   \_Inout\_\
Tipo: [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)\*

Um ponteiro para o [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) que é passado para [XAsyncRun](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncrun.md).

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

Use a porta multijogador UDP local preferencial retornada em operações subsequentes de [associação de soquete](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind). A porta é voltada especificamente para os fluxos de rede de títulos multijogador em tempo real e é significativa somente para o tráfego UDP, e não para o tráfego TCP ou HTTP.

Para escutar alterações na porta multijogador UDP local preferencial, chame [XNetworkingRegisterPreferredLocalUdpMultiplayerPortChanged](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterpreferredlocaludpmultiplayerportchanged.md).

Para obter uma descrição de como a porta multijogador UDP local funciona, confira a seção Comentários da versão síncrona de [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md).

Esse método consulta o estado local no processo de chamada e retorna rapidamente, portanto, é seguro chamá-lo a partir de contextos sensíveis ao tempo.

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

* [Porta multijogador UDP preferencial](https://docs.xbox.com/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)

## Confira também

[Porta multijogador UDP local preferencial](https://docs.xbox.com/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)\
[Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2)\
[Microsoft Azure PlayFab Party](https://docs.xbox.com/pt-BR/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)\
[XNetworking](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasyncresult.md)
- [Porta multijogador UDP preferencial](https://docs.xbox.com/pt-BR/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking.md)
- [XNetworking (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/xnetworking_members.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](https://docs.xbox.com/pt-BR/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)