> ## 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.

# XblMultiplayerManagerLobbySessionAddLocalUser

> XblMultiplayerManagerLobbySessionAddLocalUser

# XblMultiplayerManagerLobbySessionAddLocalUser

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

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionAddLocalUser(  
         XblUserHandle user  
)  
```

### 参数

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

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

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数将创建新的大厅会话，并将 *user* 中指定的 XBOX 用户添加到会话中。随后的用户将作为辅助用户被添加到新托管的大厅会话中。只有在将第一个本地用户添加到大厅会话之后，才能发送邀请、设置会话属性以及访问大厅会话的成员。<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) 向另一个用户发送邀请。如果你不需要大厅会话，并且你没有通过调用此函数添加本地用户，你可以改为调用 [XblMultiplayerManagerJoinGame](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame) 并指定要加入游戏的用户列表。

## 要求

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

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

## 另请参阅

[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)


## Related topics

- [XblMultiplayerManagerLobbySessionInviteUsers](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [使用 Multiplayer Manager 与好友玩多人游戏](/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)
- [使用 SmartMatch 和 MPM 进行多人游戏匹配](/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)