XblMultiplayerManagerJoinGame
使用全局唯一的会话名称加入游戏会话。语法
参数
sessionName _In_z_类型:char* 游戏会话的全局唯一会话名称。 sessionTemplateName _In_z_
类型:char* 游戏会话所基于的会话模板的名称。 xuids _In_opt_
类型:uint64_t* 表示你希望加入游戏的用户的 XBOX 用户 ID (XUID) 数组。 xuidsCount _In_
类型:size_t
xuids 指定的数组中的元素数量。
返回值
类型:HRESULT 此 API 操作的 HRESULT 返回代码。备注
此函数将xuids 中指定的 XBOX 用户列表加入到由 sessionName 中指定的全局唯一会话名称标识的游戏会话中。你可以从游戏的第三方匹配结果中获取全局唯一会话名称,并且应为需要加入游戏的所有客户端调用此函数。此函数的结果作为多人游戏事件传递,事件类型设置为
XblMultiplayerEventType::JoinGameCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。尝试加入游戏会话时,如果服务器已满,服务将返回
HTTP_E_STATUS_BAD_REQUEST。加入后,你可以通过调用 XblMultiplayerManagerGameSessionSetProperties 或 XblMultiplayerManagerGameSessionSetSynchronizedProperties 设置游戏会话的属性,或者你可以通过调用 XblMultiplayerManagerGameSessionSetSynchronizedHost 设置游戏会话的主机。
