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

関連項目

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby