XblMultiplayerManagerJoinGameFromLobby
为大厅会话创建新的游戏会话,或者如果大厅会话已存在游戏会话,则加入该现有游戏会话。语法
参数
sessionTemplateName _In_z_类型:char* 游戏会话所基于的会话模板的名称。
返回值
类型:HRESULT 此 API 操作的 HRESULT 返回代码。备注
如果游戏会话尚不存在,此函数将创建新的游戏会话,并将大厅会话的当前成员添加到游戏会话中。如果在已创建游戏会话之后有新用户加入大厅会话,此函数将通过使用大厅会话中的传输句柄在多人游戏会话目录 (MPSD) 中查找现有游戏会话,然后使用该传输句柄将新用户添加到游戏会话中。有关详细信息,请参阅多人游戏概念概述。如果大厅会话不存在(可能是因为在调用此函数之前未调用 XblMultiplayerManagerInitialize),则会发生错误。如果匹配正在进行中,也会发生错误。此函数不会将现有大厅会话属性迁移到游戏会话。此函数的结果作为多人游戏事件传递,事件类型设置为
XblMultiplayerEventType::JoinGameCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。尝试加入大厅会话时,如果服务器已满,服务将返回
HTTP_E_STATUS_BAD_REQUEST。加入后,你可以通过调用 XblMultiplayerManagerGameSessionSetProperties 或 XblMultiplayerManagerGameSessionSetSynchronizedProperties 设置游戏会话的属性,或者你可以通过调用 XblMultiplayerManagerGameSessionSetSynchronizedHost 设置游戏会话的主机。
要求
头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib另请参阅
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby
