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

# PartyRegionUpdateConfiguration

> The configuration used by the Party library to control how it performs automatic region discovery and connection quality measurement updates.

The configuration used by the Party library to control how it performs automatic region discovery and connection quality measurement updates.

## Syntax

```cpp theme={null}
struct PartyRegionUpdateConfiguration {  
    PartyRegionUpdateMode mode;  
    uint32_t refreshIntervalInSeconds;  
}  
```

### Members

**`mode`**   [PartyRegionUpdateMode](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)

The mode controlling when region discovery and connection quality measurement updates are performed.

The default value is [PartyRegionUpdateMode::Immediate](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) when [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) hasn't been configured.

**`refreshIntervalInSeconds`**   uint32\_t

The number of seconds allowed to elapse after region quality measurements complete before a new region discovery and connection quality measurement process may begin.

This refresh interval is used whenever a [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) is provided to determine when the next region quality measurement is eligible to start under the update mode defined by the *mode* field. <br /><br /> Becoming eligible for a refresh doesn't guarantee that the refresh begins at that exact time. If the *mode* field is set to [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode), the next refresh doesn't happen until one of the applicable methods is called to trigger a region update. The library also waits until the local device is no longer in any Party networks and applies a small amount of randomized delay to try to avoid PlayFab service load from multiple, unintentionally synchronized devices.   <br /><br /> The default value is 28800 (8 hours) when [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) hasn't been configured.   <br /><br /> A value of zero causes the Party library to never automatically refresh measurements in the future. Otherwise, the minimum allowed value is 30 seconds.

## Remarks

This structure can be used together with [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) to either override or query the Party library's current configuration via [PartyManager::SetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption) or [PartyManager::GetOption()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption) respectively. It configures the behavior of the region discovery and connection quality measurement process that produces [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) state changes.

## Requirements

**Header:** Party.h

## See also

[Party members](/services/playfab/multiplayer/networking/reference/party_members)\
[PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption)\
[PartyRegionUpdateMode](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode)\
[PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange)\
[PartyManager::SetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setoption)\
[PartyManager::GetOption](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getoption)


## Related topics

- [PartyRegionUpdateMode](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PartyOption](/services/playfab/multiplayer/networking/reference/enums/partyoption.md)
- [Party C/C++ API overview](/services/playfab/multiplayer/networking/reference/party_members.md)
- [PartyRegionQualityMeasurementConfiguration](/services/playfab/multiplayer/networking/reference/structs/partyregionqualitymeasurementconfiguration.md)
- [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md)