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

> PFMultiplayerServerPingQosServersAsync 发现 PlayFab QoS 信标，通过 UDP/3075 逐一执行 ping 操作，并返回按测得延迟排序的区域列表。

通过 PFMultiplayerServerListQosServersForTitleAsync 发现 QoS 信标，并通过 UDP/3075 逐一对其执行 ping 操作。汇总延迟并返回排序后的列表。实际耗时上限大约为 ceil(regionCount / maxConcurrentRegions) \* timeoutMs \* pingsPerRegion，再加上 ListQosServersForTitle 调用的耗时。

## 语法

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

### 参数

**`entityHandle`**   PFEntityHandle

经过身份验证的 PlayFab 实体。与 PFMultiplayerServerListQosServersForTitleAsync 接受的句柄相同。

**`options`**   [PFMultiplayerServerPingQosServersOptions\*](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions)\
*optional*

可选。NULL 表示应用 PFMultiplayerServerPingQosServersOptions 中所述的默认值。

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

用于异步操作的 XAsyncBlock。支持 XAsyncCancel。

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 备注

此 API 在所有平台上都可用。所有区域均超时的网络（例如，企业防火墙阻止了 UDP/3075）不属于故障模式：操作会以 S\_OK 完成，并且每个 PFMultiplayerServerQosResult 都会被标记为无法访问，以便调用方检测并报告这种情况。异步操作完成后，调用 [PFMultiplayerServerPingQosServersGetResultSize](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) 和 [PFMultiplayerServerPingQosServersGetResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult) 以获取结果。

## 要求

**头文件：** PFMultiplayerServerQoS.h

## 另请参阅

[PFMultiplayerServerQoS 成员](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members)


## Related topics

- [PFMultiplayerServerPingQosServersOptions](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)
- [PFMultiplayerServerPingQosServersGetResultSize](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md)
- [Services C API 概览 - PFMultiplayerServerQoS.h](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)