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

> Obtiene una matriz que contiene el conjunto de regiones para las que está configurado el título, junto con información de latencia de ida y vuelta.

Obtiene una matriz que contiene el conjunto de regiones para las que está configurado el título, junto con información de latencia de ida y vuelta.

## Sintaxis

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

### Parámetros

**`regionCount`**   uint32\_t\*\
*salida*

El número de salida de regiones proporcionadas en `regions`.

**`regions`**   [PartyRegion\*\*](/services/playfab/multiplayer/networking/reference/structs/partyregion)\
*matriz de salida asignada por la biblioteca de tamaño `*regionCount`*

Una matriz de salida asignada por la biblioteca que contiene el conjunto de regiones.

### Valor devuelto

PartyError

`c_partyErrorSuccess` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Comentarios

La matriz proporcionada por este método no se rellena hasta que se proporciona el primer [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange). Cada PartyRegionsChangedStateChange posterior indica una actualización de este conjunto de regiones. Las operaciones en segundo plano que rellenan este conjunto comienzan cuando se llama a [Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize), a menos que la opción [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) se haya usado para configurar un modo de actualización de [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode). El modo diferido significa que la recuperación de regiones y la medición de la calidad de la conexión no comienzan hasta que la aplicación llama a [CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) con una matriz de regiones de cero entradas, o no está conectada a ninguna red y llama a [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles), [PartyLocalChatControl::SetTextToSpeechProfile()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile) o [PartyLocalChatControl::SetTranscriptionOptions()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions) con marcas de opción que incluyan [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions). La opción [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) también se puede usar para configurar el intervalo tras el cual se actualizará la matriz de regiones. <br /><br /> La matriz devuelta se ordena en orden de latencia creciente. La latencia de una región se define como el tiempo de un extremo a otro que se tarda en enviar un datagrama UDP a la baliza de calidad de servicio de PlayFab de la región y recibir una respuesta. La biblioteca mide la latencia de cada región varias veces para calcular resultados de alta fidelidad. Las aplicaciones pueden modificar aspectos de bajo nivel de este procedimiento de medición de la calidad de la conexión mediante la opción [PartyOption::RegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption).   <br /><br /> Una latencia equivalente a UINT32\_MAX indica que la región es compatible, pero la información de latencia no se pudo determinar, ya sea debido a errores internos de la biblioteca o porque se alcanzó un tiempo de espera sin recibir respuesta de la baliza. Esto se puede usar con fines de diagnóstico (una latencia de UINT32\_MAX en todas las regiones probablemente indica un problema de configuración local) o para filtrar regiones que probablemente no sean viables durante la selección de regiones.   <br /><br /> Los nombres devueltos en las estructuras [PartyRegion](/services/playfab/multiplayer/networking/reference/structs/partyregion) no están localizados al idioma del usuario actual, y no se recomienda mostrar las cadenas directamente en la interfaz de usuario fuera de las tareas de solución de problemas.   <br /><br /> No dé por hecho que el conjunto de regiones devuelto seguirá siendo el mismo durante la vida del título. La biblioteca de PlayFab Party aprovechará automáticamente las adiciones y los cambios en las regiones disponibles a lo largo del tiempo para mejorar continuamente la experiencia de los usuarios finales.

## Requisitos

**Encabezado:** Party.h

## Consulte también

[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](/es/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)
- [Mediciones de QoS de PlayFab Party](/es/services/playfab/multiplayer/networking/concepts-regions.md)
- [Notas de la versión de PlayFab Party](/es/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::GetOption](/es/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption.md)
- [PartyManager::GetSingleton](/es/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)