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

# PartyManager::GetRegions

> 타이틀에 대해 구성된 지역 집합과 왕복 대기 시간 정보를 포함하는 배열을 가져옵니다.

타이틀에 대해 구성된 지역 집합과 왕복 대기 시간 정보를 포함하는 배열을 가져옵니다.

## Syntax

```cpp theme={null}
PartyError GetRegions(  
    uint32_t* regionCount,  
    const PartyRegion** regions  
)  
```

### Parameters

**`regionCount`**   uint32\_t\*\
*출력*

`regions`에 제공된 지역의 출력 개수입니다.

**`regions`**   [PartyRegion\*\*](/services/playfab/multiplayer/networking/reference/structs/partyregion)\
*크기가 `*regionCount`인 라이브러리에서 할당된 출력 배열*

지역 집합을 포함하는 라이브러리에서 할당된 출력 배열입니다.

### Return value

PartyError

호출이 성공한 경우 `c_partyErrorSuccess`, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 [GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)를 통해 검색할 수 있습니다.

## Remarks

이 메서드가 제공하는 배열은 첫 번째 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)가 제공될 때까지 채워지지 않습니다. 이후의 각 PartyRegionsChangedStateChange는 이 지역 집합에 대한 업데이트를 나타냅니다. [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션이 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) 업데이트 모드를 구성하기 위해 사용된 경우가 아니라면, 이 집합을 채우는 백그라운드 작업은 [Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)가 호출될 때 시작됩니다. 지연 모드는 애플리케이션이 항목이 없는 지역 배열로 [CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)를 호출하거나, 어떤 네트워크에도 연결되어 있지 않은 상태에서 [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles), [PartyLocalChatControl::SetTextToSpeechProfile()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile) 또는 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)를 포함하는 옵션 플래그와 함께 [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions)를 호출할 때까지 지역 검색 및 연결 품질 측정이 시작되지 않는다는 것을 의미합니다. [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션을 사용하여 지역 배열을 새로 고칠 간격을 구성할 수도 있습니다. <br /><br /> 반환된 배열은 대기 시간이 증가하는 순서로 정렬됩니다. 지역의 대기 시간은 UDP 데이터그램을 지역의 PlayFab Quality of Service 비콘으로 보내고 응답을 받는 데 걸리는 종단 간 시간으로 정의됩니다. 라이브러리는 높은 정확도의 결과를 계산하기 위해 각 지역의 대기 시간을 여러 번 측정합니다. 애플리케이션은 [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 옵션을 사용하여 이 연결 품질 측정 절차의 하위 수준 측면을 변경할 수 있습니다.   <br /><br /> UINT32\_MAX와 동등한 대기 시간은 지역이 지원되지만 라이브러리 내부의 실패로 인해 또는 비콘의 응답을 받지 못하고 타임아웃에 도달하여 대기 시간 정보를 결정할 수 없음을 나타냅니다. 이는 진단 목적으로 사용하거나(모든 지역에 대한 UINT32\_MAX 대기 시간은 로컬 구성 문제를 나타낼 가능성이 높음) 지역 선택 중에 실행 가능성이 낮은 지역을 필터링하는 데 사용할 수 있습니다.   <br /><br /> [PartyRegion](/services/playfab/multiplayer/networking/reference/structs/partyregion) 구조체에 반환되는 이름은 현재 사용자의 언어로 지역화되지 않으며, 문자열을 UI에 직접 표시하는 것은 문제 해결 외에는 권장되지 않습니다.   <br /><br /> 반환되는 지역 집합이 타이틀의 수명 동안 동일하게 유지된다고 가정하지 마세요. PlayFab Party 라이브러리는 시간이 지남에 따라 사용 가능한 지역의 추가 및 변경 사항을 자동으로 활용하여 최종 사용자를 위한 경험을 지속적으로 개선합니다.

## Requirements

**Header:** Party.h

## See also

[PartyManager](/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)


## Related topics

- [PartyRegionsChangedStateChange](/ko/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [PlayFab Party QoS measurements](/ko/services/playfab/multiplayer/networking/concepts-regions.md)
- [PlayFab Party 릴리스 정보](/ko/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetOption](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyManager::GetNetworks](/ko/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getnetworks.md)