XblMultiplayerManagerJoinGameFromLobby
ロビー セッション用の新しいゲーム セッションを作成するか、ロビー セッションに対して既存のゲーム セッションが存在する場合はそれに参加します。構文
パラメーター
sessionTemplateName _In_z_型: char* ゲーム セッションの基盤となるセッション テンプレートの名前。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
この関数は、ゲーム セッションがまだ存在しない場合、新しいゲーム セッションを作成し、ロビー セッションの現在のメンバーをゲーム セッションに追加します。ゲーム セッションが既に作成された後で新しいユーザーがロビー セッションに参加した場合、この関数はロビー セッション内の転送ハンドルを使用して Multiplayer Session Directory (MPSD) 内の既存のゲーム セッションを見つけ、その転送ハンドルを使用して新しいユーザーをゲーム セッションに追加します。詳細については、「マルチプレイヤーの概念の概要」を参照してください。ロビー セッションが存在しない場合 (この関数を呼び出す前に XblMultiplayerManagerInitialize が呼び出されていない可能性があります)、エラーが発生します。マッチメイキングが進行中の場合もエラーが発生します。この関数は、既存のロビー セッションのプロパティをゲーム セッションに移行しません。この関数の結果は、イベント タイプが
XblMultiplayerEventType::JoinGameCompleted に設定されたマルチプレイヤー イベントとして配信されます。XblMultiplayerManagerDoWork を呼び出してマルチプレイヤー イベントを取得できます。ロビー セッションに参加しようとしたときにサーバーが満員の場合、サービスは
HTTP_E_STATUS_BAD_REQUEST を返します。参加後、XblMultiplayerManagerGameSessionSetProperties または XblMultiplayerManagerGameSessionSetSynchronizedProperties を呼び出してゲーム セッションのプロパティを設定できます。また、XblMultiplayerManagerGameSessionSetSynchronizedHost を呼び出してゲーム セッションのホストを設定することもできます。
要件
ヘッダー: multiplayer_manager_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib関連項目
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby