XblMultiplayerManagerJoinLobby
XBOX ユーザーをロビー セッションに参加させます。構文
パラメーター
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_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby