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

# PFMultiplayerServerPingQosServersAsync

> Découvre les balises QoS via PFMultiplayerServerListQosServersForTitleAsync et envoie un ping à chacune d'elles via UDP/3075. Agrège les latences et renvoie la liste triée. La durée réelle écoulée est limitée à environ ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion, plus le coût de l'appel ListQosServersForTitle.

Découvre les balises QoS via PFMultiplayerServerListQosServersForTitleAsync et envoie un ping à chacune d'elles via UDP/3075. Agrège les latences et renvoie la liste triée. La durée réelle écoulée est limitée à environ ceil(regionCount / maxConcurrentRegions) \* timeoutMs \* pingsPerRegion, plus le coût de l'appel ListQosServersForTitle.

## Syntaxe

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

### Paramètres

**`entityHandle`**   PFEntityHandle

Entité PlayFab authentifiée. Il s'agit du même handle que celui accepté par PFMultiplayerServerListQosServersForTitleAsync.

**`options`**   [PFMultiplayerServerPingQosServersOptions\*](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions)<br />*optional*

Facultatif. NULL signifie que les valeurs par défaut documentées pour PFMultiplayerServerPingQosServersOptions sont appliquées.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock pour l'opération asynchrone. Prend en charge XAsyncCancel.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API.

## Notes

Cette API est disponible sur toutes les plateformes. Un réseau sur lequel toutes les régions expirent (par exemple, un pare-feu d'entreprise bloquant UDP/3075) ne constitue pas un mode d'échec : l'opération se termine avec S\_OK et chaque PFMultiplayerServerQosResult est marqué comme inaccessible, afin que les appelants puissent détecter et signaler cette situation. Une fois l'opération asynchrone terminée, appelez [PFMultiplayerServerPingQosServersGetResultSize](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) et [PFMultiplayerServerPingQosServersGetResult](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult) pour obtenir le résultat.

## Configuration requise

**En-tête :** PFMultiplayerServerQoS.h

## Voir aussi

[Membres de PFMultiplayerServerQoS](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members)


## Related topics

- [PFMultiplayerServerPingQosServersOptions](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersGetResult](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)
- [PFMultiplayerServerPingQosServersResult](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResultSize](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md)
- [Vue d'ensemble de l'API C Services - PFMultiplayerServerQoS.h](/fr/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)