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

# PFMultiplayerServerPingQosServersAsync

> PFMultiplayerServerPingQosServersAsync descobre beacons de QoS do PlayFab, executa ping em cada um por UDP/3075 e retorna uma lista de regiões ordenada pela latência medida.

Descobre beacons de QoS por meio de PFMultiplayerServerListQosServersForTitleAsync e executa ping em cada um deles por UDP/3075. Agrega as latências e retorna a lista ordenada. A duração em tempo real é limitada a aproximadamente ceil(regionCount / maxConcurrentRegions) \* timeoutMs \* pingsPerRegion mais o custo da chamada ListQosServersForTitle.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerServerPingQosServersAsync(  
    PFEntityHandle entityHandle,  
    const PFMultiplayerServerPingQosServersOptions* options,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`entityHandle`**   PFEntityHandle

Entidade do PlayFab autenticada. O mesmo identificador aceito por PFMultiplayerServerListQosServersForTitleAsync.

**`options`**   [PFMultiplayerServerPingQosServersOptions\*](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)\
*optional*

Opcional. NULL significa aplicar os padrões documentados em PFMultiplayerServerPingQosServersOptions.

**`async`**   XAsyncBlock\*\
*Inout*

XAsyncBlock para a operação assíncrona. Respeita XAsyncCancel.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Uma rede em que todas as regiões atingem o tempo limite (por exemplo, um firewall corporativo que bloqueia UDP/3075) não é um modo de falha: a operação é concluída com S\_OK e cada PFMultiplayerServerQosResult é marcado como inacessível para que os chamadores possam detectar e exibir essa condição. Quando a operação assíncrona for concluída, chame [PFMultiplayerServerPingQosServersGetResultSize](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md) e [PFMultiplayerServerPingQosServersGetResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md) para obter o resultado.

## Requisitos

**Cabeçalho:** PFMultiplayerServerQoS.h

## Confira também

[Membros de PFMultiplayerServerQoS](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)


## Related topics

- [PFMultiplayerServerPingQosServersOptions](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)
- [PFMultiplayerServerPingQosServersGetResultSize](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md)
- [Visão geral da API C do Services - PFMultiplayerServerQoS.h](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)