Skip to main content

XblMultiplayerManagerJoinLobby

将 XBOX 用户加入到大厅会话。

语法

参数

handleId   _In_z_
类型:char*
大厅会话的活动句柄。 user   _In_
类型:XblUserHandle
加入大厅会话的用户的用户句柄。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

此函数将 user 中指定的 XBOX 用户加入到 handleId 中指定的大厅会话。大厅会话的活动句柄通常从游戏邀请中检索,或者通过调用 XblMultiplayerGetActivitiesForUsersAsync 从另一个用户的 XblMultiplayerActivityDetailsHandleId 值中检索。有关多人游戏活动的详细信息,请参阅活动
此函数的结果作为多人游戏事件传递,事件类型设置为 XblMultiplayerEventType::JoinLobbyCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。
尝试加入大厅会话时,如果服务器已满,服务将返回 HTTP_E_STATUS_BAD_REQUEST
加入后,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 设置大厅会话的属性,或者如果大厅会话尚无主机,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedHost 设置大厅会话的主机。
你还可以通过调用 XblMultiplayerManagerLobbySessionInviteUsersXblMultiplayerManagerLobbySessionInviteFriends 向另一个用户发送邀请。如果你不需要大厅会话,并且你没有通过调用 XblMultiplayerManagerLobbySessionAddLocalUser 添加本地用户,你可以改为调用 XblMultiplayerManagerJoinGame 并指定要加入游戏的用户列表。

要求

头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

概念文档

另请参阅

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby
最后修改于 2026年8月24日