> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerJoinLobby

> XblMultiplayerManagerJoinLobby

# XblMultiplayerManagerJoinLobby

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

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)  
```

### 参数

*handleId*   \_In\_z\_\
类型：char\*

大厅会话的活动句柄。

*user*   \_In\_\
类型：XblUserHandle

加入大厅会话的用户的用户句柄。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数将 *user* 中指定的 XBOX 用户加入到 *handleId* 中指定的大厅会话。大厅会话的活动句柄通常从游戏邀请中检索，或者通过调用 [XblMultiplayerGetActivitiesForUsersAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforusersasync.md) 从另一个用户的 [XblMultiplayerActivityDetails](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayeractivitydetails.md) 的 `HandleId` 值中检索。有关多人游戏活动的详细信息，请参阅[活动](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities.md)。\
此函数的结果作为多人游戏事件传递，事件类型设置为 `XblMultiplayerEventType::JoinLobbyCompleted`。你可以调用 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 检索多人游戏事件。\
尝试加入大厅会话时，如果服务器已满，服务将返回 `HTTP_E_STATUS_BAD_REQUEST`。\
加入后，你可以通过调用 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md) 设置大厅会话的属性，或者如果大厅会话尚无主机，你可以通过调用 [XblMultiplayerManagerLobbySessionSetSynchronizedHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md) 设置大厅会话的主机。\
你还可以通过调用 [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md) 或 [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md) 向另一个用户发送邀请。如果你不需要大厅会话，并且你没有通过调用 [XblMultiplayerManagerLobbySessionAddLocalUser](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md) 添加本地用户，你可以改为调用 [XblMultiplayerManagerJoinGame](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md) 并指定要加入游戏的用户列表。

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 概念文档

* [接收邀请](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)

## 另请参阅

[multiplayer\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerJoinability](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability.md)\
[XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerLeaveGame](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)