XblMultiplayerManagerJoinGame
グローバルに一意なセッション名を使用して、ゲーム セッションに参加します。構文
パラメーター
sessionName _In_z_型: char* ゲーム セッションのグローバルに一意なセッション名。 sessionTemplateName _In_z_
型: char* ゲーム セッションの基盤となるセッション テンプレートの名前。 xuids _In_opt_
型: uint64_t* ゲームに参加させたいユーザーを表す XBOX ユーザー ID (XUID) の配列。 xuidsCount _In_
型: size_t
xuids に指定された配列内の要素数。
戻り値
型: HRESULT この API 操作の HRESULT 戻り値コード。解説
この関数は、xuids に指定された XBOX ユーザーのリストを、sessionName に指定されたグローバルに一意なセッション名で識別されるゲーム セッションに参加させます。グローバルに一意なセッション名は、タイトルのサードパーティー製マッチメイキングの結果から取得でき、ゲームに参加する必要があるすべてのクライアントに対してこの関数を呼び出す必要があります。この関数の結果は、イベント タイプが
XblMultiplayerEventType::JoinGameCompleted に設定されたマルチプレイヤー イベントとして配信されます。XblMultiplayerManagerDoWork を呼び出してマルチプレイヤー イベントを取得できます。ゲーム セッションに参加しようとしたときにサーバーが満員の場合、サービスは
HTTP_E_STATUS_BAD_REQUEST を返します。参加後、XblMultiplayerManagerGameSessionSetProperties または XblMultiplayerManagerGameSessionSetSynchronizedProperties を呼び出してゲーム セッションのプロパティを設定できます。また、XblMultiplayerManagerGameSessionSetSynchronizedHost を呼び出してゲーム セッションのホストを設定することもできます。