> ## 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-CA/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 les 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 tout conflit entre les 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 les appareils, utilisez plutôt la fonction [XblMultiplayerManagerGameSessionSetProperties](/fr-CA/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 retourne `HTTP_E_STATUS_PRECOND_FAILED`. Si un conflit se produit, réévaluez la nécessité de modifier la propriété personnalisée et, au besoin, appelez de nouveau cette fonction pour soumettre à nouveau la demande.  <br />Le résultat de cette fonction est livré sous forme d'événement multijoueur dont le type d'événement est défini sur `XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted`. Vous pouvez appeler [XblMultiplayerManagerDoWork](/fr-CA/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-CA/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](/fr-CA/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)\
[XblMultiplayerEvent](/fr-CA/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)