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

> 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\*\*](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregion)\
*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()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Comentários

A matriz fornecida por este método só é preenchida quando o primeiro [PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) é 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()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize) é chamado, a menos que a opção [PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) tenha sido usada para configurar um modo de atualização [PartyRegionUpdateMode::Deferred](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode). 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()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) com uma matriz de regiões sem entradas ou quando não está conectado a nenhuma rede e chama [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles), [PartyLocalChatControl::SetTextToSpeechProfile()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile), or [PartyLocalChatControl::SetTranscriptionOptions()](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) com sinalizadores de opção que incluem [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions). A opção [PartyOption::RegionUpdateConfiguration](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption) também pode ser usada para configurar o intervalo após o qual a matriz de regiões deve ser atualizada. <br /><br /> 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](/pt-BR/services/playfab/multiplayer/networking/reference/enums/partyoption).   <br /><br /> 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.   <br /><br /> Os nomes retornados nas estruturas [PartyRegion](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregion) 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.   <br /><br /> 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](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager)\
[PartyRegionsChangedStateChange](/pt-BR/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::CreateNewNetwork](/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)


## Related topics

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