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

# PartyManager::GetRegions

> Obtém uma matriz que contém o conjunto de regiões para as quais seu título está configurado, junto com informações de latência de ida e volta.

Obtém uma matriz que contém o conjunto de regiões para as quais seu título está configurado, junto com informações de latência de ida e volta.

## Sintaxe

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

### Parâmetros

**`regionCount`**   uint32\_t\*\
*saída*

O número de saída de regiões fornecidas em `regions`.

**`regions`**   [PartyRegion\*\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregion.md)\
*matriz de saída alocada pela biblioteca de tamanho `*regionCount`*

Uma matriz de saída alocada pela biblioteca que contém o conjunto de regiões.

### Valor retornado

PartyError

`c_partyErrorSuccess` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Comentários

A matriz fornecida por este método só é preenchida quando o primeiro [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) é fornecido. Cada PartyRegionsChangedStateChange subsequente indica uma atualização desse conjunto de regiões. As operações em segundo plano que preenchem esse conjunto começam quando [Initialize()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) é chamado, a menos que a opção [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) tenha sido usada para configurar um modo de atualização [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md). O modo adiado significa que a recuperação das regiões e a medição da qualidade da conexão só começam quando o aplicativo chama [CreateNewNetwork()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) com uma matriz de regiões sem entradas ou quando não está conectado a nenhuma rede e chama [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md), [PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md), or [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) com sinalizadores de opção que incluem [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md). A opção [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md) também pode ser usada para configurar o intervalo após o qual a matriz de regiões deve ser atualizada. \
\
 A matriz retornada é ordenada por latência crescente. A latência de uma região é definida como o tempo de ponta a ponta necessário para enviar um datagrama UDP ao beacon de Qualidade de Serviço do PlayFab da região e receber uma resposta. A biblioteca mede a latência de cada região várias vezes para calcular resultados de alta fidelidade. Os aplicativos podem alterar aspectos de baixo nível desse procedimento de medição da qualidade da conexão usando a opção [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption.md).   \
\
 Uma latência equivalente a UINT32\_MAX indica que a região tem suporte, mas não foi possível determinar as informações de latência, seja devido a falhas internas da biblioteca, seja porque um tempo limite foi atingido sem receber resposta do beacon. Isso pode ser usado para fins de diagnóstico (uma latência UINT32\_MAX para todas as regiões provavelmente indica um problema de configuração local) ou para filtrar regiões que provavelmente não serão viáveis durante a seleção de região.   \
\
 Os nomes retornados nas estruturas [PartyRegion](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregion.md) não são localizados para o idioma do usuário atual, e não é recomendável exibir as cadeias de caracteres diretamente na interface do usuário fora da solução de problemas.   \
\
 Não presuma que o conjunto de regiões retornado permanecerá o mesmo durante a vida útil do seu título. A biblioteca do PlayFab Party aproveitará automaticamente as adições e alterações nas regiões disponíveis ao longo do tempo para melhorar continuamente a experiência dos usuários finais.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[PartyManager](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager.md)\
[PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)\
[PartyManager::CreateNewNetwork](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)


## Related topics

- [PartyRegionsChangedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [Medições de QoS do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/concepts-regions.md)
- [Notas de versão do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetOption](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyManager::GetSingleton](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)