次の方法で共有

XblMatchmakingCreateMatchTicketAsync

  • [アーティクル]

マッチメイキング要求をサーバーに送信し、チケット ID を設定したマッチ チケットを返します。結果を取得するには、完了時に XblMatchmakingCreateMatchTicketResult を呼び出します。

構文

HRESULT XblMatchmakingCreateMatchTicketAsync(  
         XblContextHandle xboxLiveContext,  
         XblMultiplayerSessionReference ticketSessionReference,  
         const char* matchmakingServiceConfigurationId,  
         const char* hopperName,  
         const uint64_t ticketTimeout,  
         XblPreserveSessionMode preserveSession,  
         const char* ticketAttributesJson,  
         XAsyncBlock* asyncBlock  
)

パラメーター

xboxLiveContext _In_
型: XblContextHandle

ローカル ユーザーの Xbox Live コンテキスト。

ticketSessionReference _In_
型: XblMultiplayerSessionReference

マッチに使用するマルチプレイヤー セッション。

matchmakingServiceConfigurationId _In_
型: char*

マッチのサービス構成 ID。

hopperName _In_
型: char*

ホッパーの名前。

ticketTimeout _In_
型: uint64_t

プレイヤーがセッションに参加するまで待機する最大時間。

preserveSession _In_
型: XblPreserveSessionMode

セッションを保持する必要があるかどうかを示します。

ticketAttributesJson _In_
型: char*

セッションのチケット属性。 (オプション)

asyncBlock _In_
型: XAsyncBlock*

この操作の AsyncBlock。

戻り値

型: HRESULT

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

解説

マッチ チケット オブジェクトには、チケット ID や待機時間などのサーバーから返された情報が含まれ、チケット データ オブジェクトからのタイトル指定データのコピーも含まれます。

REST 呼び出し

V103 POST /serviceconfigs/{serviceConfigId}/hoppers/{hopperName} を呼び出します

要件

ヘッダー: matchmaking_c.h

ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

matchmaking_c