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

# XblMultiplayerManagerLobbySessionSetSynchronizedProperties

> XblMultiplayerManagerLobbySessionSetSynchronizedProperties

# XblMultiplayerManagerLobbySessionSetSynchronizedProperties

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

## Sintaxis

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionSetSynchronizedProperties(  
         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 de inicio.

### 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 de la sesión de sala. Las propiedades personalizadas se pueden cambiar en cualquier momento. Si las propiedades personalizadas se comparten entre dispositivos, o si varios dispositivos pueden actualizarlas al mismo tiempo, use esta función para garantizar la atomicidad y resolver los conflictos entre dispositivos mientras se cambian los valores de esas propiedades personalizadas. Si una propiedad personalizada no se comparte entre dispositivos, use en su lugar la función [XblMultiplayerManagerLobbySessionSetProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetproperties) 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)\
[XblMultiplayerManagerLobbySessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost)\
[XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)


## Related topics

- [XblMultiplayerManagerLobbySessionSetSynchronizedHost](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md)
- [XblMultiplayerManagerLobbySessionPropertiesJson](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionpropertiesjson.md)
- [XblMultiplayerManagerLobbySessionSetProperties](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetproperties.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/es/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [Información general sobre la API de Multiplayer Manager](/es/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)