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

Define o valor de uma propriedade personalizada da sessão de jogo usando `XblMultiplayerSessionWriteMode::SynchronizedUpdate`.

## Sintaxe

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

### Parâmetros

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

O nome da propriedade personalizada a ser definida.

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

O valor a ser atribuído à propriedade, como uma cadeia de caracteres JSON.

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

Opcional. Os dados definidos pelo aplicativo para correlacionar o [XblMultiplayerEvent](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) à chamada inicial.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Esta função define o valor, representado como uma cadeia de caracteres JSON, de uma propriedade personalizada da sessão de jogo. As propriedades personalizadas podem ser alteradas a qualquer momento. Se as propriedades personalizadas forem compartilhadas entre dispositivos ou puderem ser atualizadas por vários dispositivos ao mesmo tempo, use esta função para garantir a atomicidade e resolver quaisquer conflitos entre dispositivos ao alterar os valores dessas propriedades personalizadas. Se uma propriedade personalizada não for compartilhada entre dispositivos, use a função [XblMultiplayerManagerGameSessionSetProperties](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) para alterar o valor dessa propriedade personalizada. <br />O serviço pode rejeitar a solicitação para alterar a propriedade personalizada se ocorrer uma condição de corrida devido a um conflito. Se a solicitação for rejeitada, o serviço retornará `HTTP_E_STATUS_PRECOND_FAILED`. Se ocorrer um conflito, reavalie a necessidade de alterar a propriedade personalizada e, se necessário, chame esta função novamente para reenviar a solicitação.  <br />O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar eventos multijogador.

## Requisitos

**Cabeçalho:** multiplayer\_manager\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[multiplayer\_manager\_c](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)\
[XblMultiplayerEvent](/pt-BR/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)
- [XblMultiplayerManagerGameSessionSetProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md)
- [XblMultiplayerManagerGameSessionPropertiesJson](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionpropertiesjson.md)
- [XblMultiplayerManagerJoinGame](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)