XblMultiplayerManagerLobbySessionAddLocalUser

Xbox ユーザーがロビー セッションに参加するようにします。

構文

HRESULT XblMultiplayerManagerLobbySessionAddLocalUser(  
         XblUserHandle user  
)  

パラメーター

user _In_
型: XblUserHandle

ロビー セッションに参加しているユーザーのユーザー ハンドル。

戻り値

型: HRESULT

この API 操作の HRESULT 結果コード。

解説

この関数により、新しいロビー セッションが作成され、[ユーザー] 内で指定された 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