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

# PartyRegionsChangedStateChange

> Informations spécifiques au type de changement d'état *RegionsChanged*.

Informations spécifiques au type de changement d'état *RegionsChanged*.

## Syntaxe

```cpp theme={null}
struct PartyRegionsChangedStateChange : PartyStateChange {  
    PartyStateChangeResult result;  
    PartyError errorDetail;  
}  
```

### Membres

**`result`**   [PartyStateChangeResult](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md)

Indique si une opération en arrière-plan visant à interroger la liste des régions prises en charge et la latence vers chaque région a réussi, ou fournit la raison de son échec.

Lorsque le résultat est [PartyStateChangeResult::Succeeded](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md), la liste des régions fournie par [PartyManager::GetRegions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md) est remplie avec les résultats de l'opération. En cas d'échec, la liste des régions fournie par PartyManager::GetRegions() est vide. \
\
 Si le résultat est [PartyStateChangeResult::FailedToBindToLocalUdpSocket](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partystatechangeresult.md), la bibliothèque n'a pas pu se lier au socket UDP local spécifié dans l'option [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md). Le titre doit nettoyer son instance de la bibliothèque, mettre à jour l'option [PartyOption::LocalUdpSocketBindAddress](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md) avec une adresse de liaison valide et disponible, puis réinitialiser la bibliothèque.

**`errorDetail`**   PartyError

Valeur de diagnostic fournissant des informations de dépannage supplémentaires sur toute condition d'erreur potentielle.

La forme lisible de ce détail d'erreur peut être obtenue via [PartyManager::GetErrorMessage()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Remarques

La récupération de la liste des régions disponibles et la mesure de la qualité de connexion vers celles-ci se produisent automatiquement en arrière-plan. Cette opération est lancée pour la première fois lorsque [PartyManager::Initialize()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) est appelé, sauf si l'option [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md) a été utilisée pour configurer un mode de mise à jour [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md), auquel cas les mises à jour des régions peuvent ne jamais se produire. Les mises à jour différées des régions ne se produisent que si l'application appelle [PartyManager::CreateNewNetwork()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) avec un tableau de régions vide, ou si elle n'est pas connectée à un réseau existant mais appelle [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md), [PartyLocalChatControl::SetTextToSpeechProfile()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md) ou [PartyLocalChatControl::SetTranscriptionOptions()](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settranscriptionoptions.md) avec des indicateurs d'option incluant [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md). L'option [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md) peut également être utilisée pour configurer l'intervalle après lequel les régions sont actualisées. \
\
 Le temps nécessaire pour récupérer la liste des régions disponibles et mesurer la qualité de connexion vers celles-ci dépend de nombreux facteurs environnementaux ou dynamiques, et du fait que l'option [PartyOption::RegionQualityMeasurementConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyoption.md) ait été utilisée ou non pour modifier les paramètres de mesure de bas niveau. Le champ *totalMeasurementTimeoutInMilliseconds* de la structure [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md) permet de configurer le délai d'expiration maximal dans le pire des cas avant que toutes les mesures soient considérées comme terminées et que ce changement d'état soit généré.

## Configuration requise

**En-tête :** Party.h

## Voir aussi

[Membres de Party](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/party_members.md)\
[PartyManager::GetRegions](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)


## Related topics

- [PartyManager::GetRegions](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getregions.md)
- [PartyRegionUpdateConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partyregionupdateconfiguration.md)
- [PartyRegionQualityMeasurementConfiguration](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionUpdateMode](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [Mesures QoS de PlayFab Party](https://docs.xbox.com/fr/services/playfab/multiplayer/networking/concepts-regions.md)