XblMultiplayerManagerJoinLobby

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

語法

HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)  

handleId _In_z_
類型：char* 大廳工作階段的活動控制代碼。 user _In_
類型：XblUserHandle 加入大廳工作階段之使用者的使用者控制代碼。

類型：HRESULT 此 API 作業的 HRESULT 傳回碼。

此函式會將 user 中指定的 XBOX 使用者加入 handleId 中指定的大廳工作階段。大廳工作階段的活動控制代碼通常是從遊戲邀請取得，或藉由呼叫 XblMultiplayerGetActivitiesForUsersAsync，從其他使用者之 XblMultiplayerActivityDetails 的 HandleId 值取得。如需多人遊戲活動的詳細資訊，請參閱活動。
此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 XblMultiplayerEventType::JoinLobbyCompleted。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。
嘗試加入大廳工作階段時，如果伺服器已滿，服務會傳回 HTTP_E_STATUS_BAD_REQUEST。
加入之後，您可以呼叫 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 來設定大廳工作階段的屬性；如果大廳工作階段尚無主機，也可以呼叫 XblMultiplayerManagerLobbySessionSetSynchronizedHost 來設定大廳工作階段的主機。
您也可以呼叫 XblMultiplayerManagerLobbySessionInviteUsers 或 XblMultiplayerManagerLobbySessionInviteFriends 來傳送邀請給其他使用者。如果您不需要大廳工作階段，而且尚未呼叫 XblMultiplayerManagerLobbySessionAddLocalUser 來新增本機使用者，則可以改為呼叫 XblMultiplayerManagerJoinGame 並指定要加入遊戲的使用者清單。

標頭： multiplayer_manager_c.h 程式庫： Microsoft.Xbox.Services.14x.GDK.C.lib