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

Establece el valor de una propiedad personalizada para la sesión de juego, mediante `XblMultiplayerSessionWriteMode::SynchronizedUpdate`.

## Sintaxis

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

### Parámetros

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

El nombre de la propiedad personalizada que se va a establecer.

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

El valor que se va a asignar a la propiedad, como una cadena JSON.

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

Opcional. Los datos definidos por la aplicación para correlacionar el [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) con la llamada iniciadora.

### Valor devuelto

Tipo: HRESULT

Código de retorno HRESULT para esta operación de API.

## Comentarios

Esta función establece el valor, representado como una cadena JSON, de una propiedad personalizada para la sesión de juego. Las propiedades personalizadas se pueden cambiar en cualquier momento. Si las propiedades personalizadas se comparten entre dispositivos, o si pueden ser actualizadas por varios dispositivos al mismo tiempo, use esta función para garantizar la atomicidad y resolver cualquier conflicto entre dispositivos al cambiar los valores de esas propiedades personalizadas. Si una propiedad personalizada no se comparte entre dispositivos, use en su lugar la función [XblMultiplayerManagerGameSessionSetProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) para cambiar el valor de esa propiedad personalizada. <br />El servicio puede rechazar la solicitud de cambiar la propiedad personalizada si se produce una condición de carrera debido a un conflicto. Si se rechaza la solicitud, el servicio devuelve `HTTP_E_STATUS_PRECOND_FAILED`. Si se produce un conflicto, vuelva a evaluar la necesidad de cambiar la propiedad personalizada y, si es necesario, llame de nuevo a esta función para volver a enviar la solicitud.  <br />El resultado de esta función se entrega como un evento multijugador con un tipo de evento establecido en `XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted`. Puede llamar a [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar los eventos multijugador.

## Requisitos

**Encabezado:** multiplayer\_manager\_c.h

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

## Consulte también

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


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedHost](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionPropertiesJson](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionpropertiesjson.md)
- [XblMultiplayerManagerGameSessionSetProperties](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md)
- [XblMultiplayerManagerJoinGame](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)
- [Información general sobre la API de Multiplayer Manager](/es/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)