Skip to main content

XblMultiplayerManagerJoinGame

Se une a una sesión de juego, mediante el nombre de sesión único global.

Sintaxis

Parámetros

sessionName   _In_z_
Tipo: char*
El nombre de sesión único global para la sesión de juego. sessionTemplateName   _In_z_
Tipo: char*
El nombre de la plantilla de sesión en la que se basará la sesión de juego. xuids   _In_opt_
Tipo: uint64_t*
Una matriz de id. de usuario de XBOX (XUID) que representa a los usuarios que quiere que formen parte del juego. xuidsCount   _In_
Tipo: size_t
El número de elementos de la matriz especificada para xuids.

Valor devuelto

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

Comentarios

Esta función une una lista de usuarios de XBOX, especificados en xuids, a la sesión de juego identificada por el nombre de sesión único global especificado en sessionName. Puede obtener el nombre de sesión único global de los resultados del emparejamiento de terceros del título, y debe llamar a esta función para todos los clientes que necesiten unirse al 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 juego, 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
Última modificación el 28 de agosto de 2026