> ## 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](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforusersasync)，從其他使用者之 [XblMultiplayerActivityDetails](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayeractivitydetails) 的 `HandleId` 值取得。如需多人遊戲活動的詳細資訊，請參閱[活動](/zh-TW/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities)。<br />此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::JoinLobbyCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 來擷取多人遊戲事件。<br />嘗試加入大廳工作階段時，如果伺服器已滿，服務會傳回 `HTTP_E_STATUS_BAD_REQUEST`。<br />加入之後，您可以呼叫 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties) 來設定大廳工作階段的屬性；如果大廳工作階段尚無主機，也可以呼叫 [XblMultiplayerManagerLobbySessionSetSynchronizedHost](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost) 來設定大廳工作階段的主機。<br />您也可以呼叫 [XblMultiplayerManagerLobbySessionInviteUsers](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers) 或 [XblMultiplayerManagerLobbySessionInviteFriends](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends) 來傳送邀請給其他使用者。如果您不需要大廳工作階段，而且尚未呼叫 [XblMultiplayerManagerLobbySessionAddLocalUser](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser) 來新增本機使用者，則可以改為呼叫 [XblMultiplayerManagerJoinGame](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame) 並指定要加入遊戲的使用者清單。

## 需求

**標頭：** multiplayer\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 概念文件

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

## 另請參閱

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


## Related topics

- [XblMultiplayerManagerJoinLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerJoinGameFromLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)