Skip to main content

XblMultiplayerManagerLobbySessionAddLocalUser

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

語法

參數

user   _In_
類型:XblUserHandle
加入大廳工作階段之使用者的使用者控制代碼。

傳回值

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

備註

此函式會建立新的大廳工作階段,並將 user 中指定的 XBOX 使用者新增至該工作階段。後續的使用者會以次要使用者的身分新增至新主控的大廳工作階段。只有在第一個本機使用者新增至大廳工作階段之後,您才能傳送邀請、設定工作階段屬性,以及存取大廳工作階段的成員。
此函式的結果會以多人遊戲事件的形式傳遞,其事件類型設定為 XblMultiplayerEventType::JoinLobbyCompleted。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。
嘗試加入大廳工作階段時,如果伺服器已滿,服務會傳回 HTTP_E_STATUS_BAD_REQUEST。
加入之後,您可以呼叫 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 來設定大廳工作階段的屬性;如果大廳工作階段尚無主機,也可以呼叫 XblMultiplayerManagerLobbySessionSetSynchronizedHost 來設定大廳工作階段的主機。
您也可以呼叫 XblMultiplayerManagerLobbySessionInviteUsers 或 XblMultiplayerManagerLobbySessionInviteFriends 來傳送邀請給其他使用者。如果您不需要大廳工作階段,而且尚未呼叫此函式來新增本機使用者,則可以改為呼叫 XblMultiplayerManagerJoinGame 並指定要加入遊戲的使用者清單。

需求

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

另請參閱

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby
Last modified on October 6, 2026