Skip to main content

XblMultiplayerManagerJoinGameFromLobby

Crea una nueva sesión de juego para la sesión de sala, o se une a una sesión de juego existente si ya existe una para la sesión de sala.

Sintaxis

Parámetros

sessionTemplateName   _In_z_
Tipo: char*
El nombre de la plantilla de sesión en la que se basará la sesión de juego.

Valor devuelto

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

Comentarios

Esta función crea una nueva sesión de juego y agrega los miembros actuales de la sesión de sala a la sesión de juego, si aún no existe una sesión de juego. Si un nuevo usuario se une a la sesión de sala después de que ya se haya creado una sesión de juego, esta función busca la sesión de juego existente en el Directorio de sesiones multijugador (MPSD) mediante un identificador de transferencia en la sesión de sala y, a continuación, agrega el nuevo usuario a la sesión de juego usando ese identificador de transferencia. Para obtener más información, consulte Información general de los conceptos multijugador. Si no existe una sesión de sala, probablemente porque no se llamó a XblMultiplayerManagerInitialize antes de llamar a esta función, se produce un error. También se produce un error si el emparejamiento está en curso. Esta función no migra las propiedades existentes de la sesión de sala a la sesión de juego.
El resultado de esta función se entrega como un evento multijugador con un tipo de evento establecido en XblMultiplayerEventType::JoinGameCompleted. Puede llamar a XblMultiplayerManagerDoWork para recuperar los eventos multijugador.
Al intentar unirse a una sesión de sala, el servicio devuelve HTTP_E_STATUS_BAD_REQUEST si el servidor está lleno.
Después de unirse, puede establecer las propiedades de la sesión de juego llamando a XblMultiplayerManagerGameSessionSetProperties o XblMultiplayerManagerGameSessionSetSynchronizedProperties, o puede establecer el host de la sesión de juego llamando a XblMultiplayerManagerGameSessionSetSynchronizedHost.

Requisitos

Encabezado: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Consulte también

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby
Última modificación el 28 de agosto de 2026