XblMultiplayerManagerGameSessionSetSynchronizedProperties
Define o valor de uma propriedade personalizada da sessão de jogo usandoXblMultiplayerSessionWriteMode::SynchronizedUpdate.
Sintaxe
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 à 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 para alterar o valor dessa propriedade personalizada.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. O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted. Você pode chamar XblMultiplayerManagerDoWork para recuperar eventos multijogador.
Requisitos
Cabeçalho: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.libConfira também
multiplayer_manager_cXblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent