Skip to main content

XblMatchmakingCreateMatchTicketAsync

サーバーにマッチメイキング リクエストを送信し、チケット ID を持つマッチ チケットを返します。結果を取得するには、完了時に XblMatchmakingCreateMatchTicketResult を呼び出します。

構文

パラメーター

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

要件

ヘッダー: matchmaking_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

matchmaking_c
最終更新日 2026年8月24日