Skip to main content

XblMatchmakingCreateMatchTicketAsync

將配對要求傳送至伺服器,並傳回具有票證識別碼的配對票證。完成時呼叫 XblMatchmakingCreateMatchTicketResult 以取得結果。

語法

參數

xboxLiveContext   _In_
類型:XblContextHandle
本機使用者的 XBOX Live 內容。 ticketSessionReference   _In_
類型:XblMultiplayerSessionReference
要用於配對的多人遊戲工作階段。 matchmakingServiceConfigurationId   _In_
類型:char*
配對的服務設定識別碼。 hopperName   _In_
類型:char*
hopper 的名稱。 ticketTimeout   _In_
類型:uint64_t
等待玩家加入工作階段的最長時間。 preserveSession   _In_
類型:XblPreserveSessionMode
表示是否應保留工作階段。 ticketAttributesJson   _In_
類型:char*
工作階段的票證屬性。(選用) asyncBlock   _In_
類型:XAsyncBlock*
此作業的 AsyncBlock。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

配對票證物件包含伺服器傳回的資訊 (例如票證識別碼和等候時間),也包含票證資料物件中遊戲指定資料的複本。

REST 呼叫

呼叫 V103 POST /serviceconfigs//hoppers/

需求

標頭: matchmaking_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

matchmaking_c
Last modified on October 6, 2026