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_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby