XblMultiplayerManagerJoinLobby
将 XBOX 用户加入到大厅会话。语法
参数
handleId _In_z_类型:char* 大厅会话的活动句柄。 user _In_
类型:XblUserHandle 加入大厅会话的用户的用户句柄。
返回值
类型:HRESULT 此 API 操作的 HRESULT 返回代码。备注
此函数将 user 中指定的 XBOX 用户加入到 handleId 中指定的大厅会话。大厅会话的活动句柄通常从游戏邀请中检索,或者通过调用 XblMultiplayerGetActivitiesForUsersAsync 从另一个用户的 XblMultiplayerActivityDetails 的HandleId 值中检索。有关多人游戏活动的详细信息,请参阅活动。此函数的结果作为多人游戏事件传递,事件类型设置为
XblMultiplayerEventType::JoinLobbyCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。尝试加入大厅会话时,如果服务器已满,服务将返回
HTTP_E_STATUS_BAD_REQUEST。加入后,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 设置大厅会话的属性,或者如果大厅会话尚无主机,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedHost 设置大厅会话的主机。
你还可以通过调用 XblMultiplayerManagerLobbySessionInviteUsers 或 XblMultiplayerManagerLobbySessionInviteFriends 向另一个用户发送邀请。如果你不需要大厅会话,并且你没有通过调用 XblMultiplayerManagerLobbySessionAddLocalUser 添加本地用户,你可以改为调用 XblMultiplayerManagerJoinGame 并指定要加入游戏的用户列表。
要求
头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib概念文档
另请参阅
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby
