Skip to main content

XblMultiplayerManagerLobbySessionSetProperties

Define o valor de uma propriedade personalizada da sessão de lobby.

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 lobby. As propriedades personalizadas podem ser alteradas a qualquer momento. As alterações são agrupadas em lote e gravadas no serviço quando XblMultiplayerManagerDoWork é chamado. Se as propriedades personalizadas forem compartilhadas entre dispositivos ou puderem ser atualizadas por vários dispositivos ao mesmo tempo, use a função XblMultiplayerManagerLobbySessionSetSynchronizedProperties para alterar as propriedades personalizadas. Caso contrário, você pode usar esta função para alterar as propriedades personalizadas.
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como XblMultiplayerEventType::SessionPropertyWriteCompleted. Você pode chamar 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
XblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent
Last modified on October 6, 2026