XblMultiplayerManagerGameSessionSetSynchronizedProperties
Establece el valor de una propiedad personalizada para la sesión de juego, medianteXblMultiplayerSessionWriteMode::SynchronizedUpdate.
Sintaxis
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 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 para cambiar el valor de esa propiedad personalizada.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. 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 para recuperar los eventos multijugador.
Requisitos
Encabezado: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.libConsulte también
multiplayer_manager_cXblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent