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

## 要求

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

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

## 概念文档

* [接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerJoinability](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability)\
[XblMultiplayerManagerJoinGameFromLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby)