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

# XblMultiplayerManagerLobbySessionAddLocalUser

> XblMultiplayerManagerLobbySessionAddLocalUser

# XblMultiplayerManagerLobbySessionAddLocalUser

將 XBOX 使用者加入大廳工作階段。

## 語法

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

### 參數

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

加入大廳工作階段之使用者的使用者控制代碼。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會建立新的大廳工作階段，並將 *user* 中指定的 XBOX 使用者新增至該工作階段。後續的使用者會以次要使用者的身分新增至新主控的大廳工作階段。只有在第一個本機使用者新增至大廳工作階段之後，您才能傳送邀請、設定工作階段屬性，以及存取大廳工作階段的成員。\
此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::JoinLobbyCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 來擷取多人遊戲事件。\
嘗試加入大廳工作階段時，如果伺服器已滿，服務會傳回 `HTTP_E_STATUS_BAD_REQUEST`。\
加入之後，您可以呼叫 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md) 來設定大廳工作階段的屬性；如果大廳工作階段尚無主機，也可以呼叫 [XblMultiplayerManagerLobbySessionSetSynchronizedHost](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md) 來設定大廳工作階段的主機。\
您也可以呼叫 [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md) 或 [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md) 來傳送邀請給其他使用者。如果您不需要大廳工作階段，而且尚未呼叫此函式來新增本機使用者，則可以改為呼叫 [XblMultiplayerManagerJoinGame](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.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)\
[XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)


## Related topics

- [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [使用多人遊戲管理員與好友一起玩多人遊戲](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)
- [使用多人遊戲管理員透過 SmartMatch 啟用尋找多人遊戲](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)