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

# XblMultiplayerManagerJoinGameFromLobby

> XblMultiplayerManagerJoinGameFromLobby

# XblMultiplayerManagerJoinGameFromLobby

为大厅会话创建新的游戏会话，或者如果大厅会话已存在游戏会话，则加入该现有游戏会话。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGameFromLobby(  
         const char* sessionTemplateName  
)  
```

### 参数

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

游戏会话所基于的会话模板的名称。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

如果游戏会话尚不存在，此函数将创建新的游戏会话，并将大厅会话的当前成员添加到游戏会话中。如果在已创建游戏会话之后有新用户加入大厅会话，此函数将通过使用大厅会话中的传输句柄在多人游戏会话目录 (MPSD) 中查找现有游戏会话，然后使用该传输句柄将新用户添加到游戏会话中。有关详细信息，请参阅[多人游戏概念概述](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)。如果大厅会话不存在（可能是因为在调用此函数之前未调用 [XblMultiplayerManagerInitialize](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize.md)），则会发生错误。如果匹配正在进行中，也会发生错误。此函数不会将现有大厅会话属性迁移到游戏会话。\
此函数的结果作为多人游戏事件传递，事件类型设置为 `XblMultiplayerEventType::JoinGameCompleted`。你可以调用 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 检索多人游戏事件。\
尝试加入大厅会话时，如果服务器已满，服务将返回 `HTTP_E_STATUS_BAD_REQUEST`。\
加入后，你可以通过调用 [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md) 或 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md) 设置游戏会话的属性，或者你可以通过调用 [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md) 设置游戏会话的主机。

## 要求

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

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

## 另请参阅

[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)\
[XblMultiplayerManagerJoinGame](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)\
[XblMultiplayerManagerJoinLobby](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)


## Related topics

- [XblMultiplayerManagerJoinLobby](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [使用 Multiplayer Manager 与好友玩多人游戏](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)
- [XblMultiplayerManagerLeaveGame](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)