> ## 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 傳回碼。

## 備註

如果遊戲工作階段尚不存在，此函式會建立新的遊戲工作階段，並將大廳工作階段目前的成員新增至遊戲工作階段。如果在遊戲工作階段建立之後有新使用者加入大廳工作階段，此函式會使用大廳工作階段中的傳輸控制代碼，在 Multiplayer Session Directory (MPSD) 中尋找現有的遊戲工作階段，然後使用該傳輸控制代碼將新使用者新增至遊戲工作階段。如需詳細資訊，請參閱[多人遊戲概念概觀](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)。如果大廳工作階段不存在 (可能是因為在呼叫此函式之前未呼叫 [XblMultiplayerManagerInitialize](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize.md))，就會發生錯誤。如果配對正在進行中，也會發生錯誤。此函式不會將現有的大廳工作階段屬性移轉至遊戲工作階段。\
此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::JoinGameCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 來擷取多人遊戲事件。\
嘗試加入大廳工作階段時，如果伺服器已滿，服務會傳回 `HTTP_E_STATUS_BAD_REQUEST`。\
加入之後，您可以呼叫 [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md) 或 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md) 來設定遊戲工作階段的屬性，或呼叫 [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerJoinability](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability.md)\
[XblMultiplayerManagerJoinGame](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)\
[XblMultiplayerManagerJoinLobby](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)


## Related topics

- [XblMultiplayerManagerJoinLobby](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [XblMultiplayerManagerLeaveGame](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [使用多人遊戲管理員與好友一起玩多人遊戲](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)