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

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

> XblMultiplayerManagerGameSessionSetSynchronizedProperties

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

Définit la valeur d'une propriété personnalisée pour la session de jeu, en utilisant `XblMultiplayerSessionWriteMode::SynchronizedUpdate`.

## Syntaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerGameSessionSetSynchronizedProperties(  
         const char* name,  
         const char* valueJson,  
         void* context  
)  
```

### Paramètres

*name*   \_In\_z\_\
Type : char\*

Le nom de la propriété personnalisée à définir.

*valueJson*   \_In\_z\_\
Type : char\*

La valeur à attribuer à la propriété, sous forme de chaîne JSON.

*context*   \_In\_opt\_\
Type : void\*

Facultatif. Les données définies par l'application permettant de corréler le [XblMultiplayerEvent](/fr/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) à l'appel initiateur.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Remarques

Cette fonction définit la valeur, représentée sous forme de chaîne JSON, d'une propriété personnalisée pour la session de jeu. Les propriétés personnalisées peuvent être modifiées à tout moment. Si des propriétés personnalisées sont partagées entre des appareils, ou peuvent être mises à jour par plusieurs appareils en même temps, utilisez cette fonction pour garantir l'atomicité et résoudre les conflits entre appareils lors de la modification des valeurs de ces propriétés personnalisées. Si une propriété personnalisée n'est pas partagée entre des appareils, utilisez plutôt la fonction [XblMultiplayerManagerGameSessionSetProperties](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) pour modifier la valeur de cette propriété personnalisée. <br />Le service peut rejeter la demande de modification de la propriété personnalisée si une condition de concurrence se produit en raison d'un conflit. Si la demande est rejetée, le service renvoie `HTTP_E_STATUS_PRECOND_FAILED`. En cas de conflit, réévaluez la nécessité de modifier la propriété personnalisée et, si nécessaire, appelez à nouveau cette fonction pour soumettre de nouveau la demande.  <br />Le résultat de cette fonction est transmis sous forme d'événement multijoueur dont le type d'événement est défini sur `XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted`. Vous pouvez appeler [XblMultiplayerManagerDoWork](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) pour récupérer les événements multijoueurs.

## Configuration requise

**En-tête :** multiplayer\_manager\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[multiplayer\_manager\_c](/fr/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](/fr/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)\
[XblMultiplayerEvent](/fr/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)