XblMultiplayerManagerJoinGame

  • [アーティクル]

グローバルに一意なセッション名を使用して、ゲーム セッションに参加します。

構文

HRESULT XblMultiplayerManagerJoinGame(  
         const char* sessionName,  
         const char* sessionTemplateName,  
         const uint64_t* xuids,  
         size_t xuidsCount  
)

パラメーター

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 を呼び出します。

要件

ヘッダー: multiplayer_manager_c.h

図書館： Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_manager_c