> ## 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 호출 비용을 더한 값으로 제한됩니다.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증된 PlayFab 엔터티입니다. PFMultiplayerServerListQosServersForTitleAsync에서 허용하는 것과 동일한 핸들입니다.

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

선택 사항입니다. NULL이면 PFMultiplayerServerPingQosServersOptions에 설명된 기본값이 적용됩니다.

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

비동기 작업을 위한 XAsyncBlock입니다. XAsyncCancel을 지원합니다.

### Return value

Type: HRESULT

이 API 작업의 결과 코드입니다.

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 모든 지역이 시간 초과되는 네트워크(예: 회사 방화벽이 UDP/3075를 차단하는 경우)는 실패 모드가 아닙니다. 작업은 S\_OK로 완료되며 모든 PFMultiplayerServerQosResult가 연결할 수 없음으로 표시되므로 호출자가 해당 상태를 감지하고 표시할 수 있습니다. 비동기 작업이 완료되면 [PFMultiplayerServerPingQosServersGetResultSize](/ko/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) 및 [PFMultiplayerServerPingQosServersGetResult](/ko/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult)를 호출하여 결과를 가져옵니다.

## Requirements

**Header:** PFMultiplayerServerQoS.h

## See also

[PFMultiplayerServerQoS members](/ko/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members)


## Related topics

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