XblMultiplayerManagerJoinLobby

将 Xbox 用户加入大厅会话。

语法

HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)

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