Skip to main content

XblMatchmakingCreateMatchTicketAsync

向服务器发送匹配请求,并返回带有票证 ID 的匹配票证。完成后调用 XblMatchmakingCreateMatchTicketResult 以获取结果。

语法

参数

xboxLiveContext   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 ticketSessionReference   _In_
类型:XblMultiplayerSessionReference
用于匹配的多玩家会话。 matchmakingServiceConfigurationId   _In_
类型:char*
用于匹配的服务配置 ID。 hopperName   _In_
类型:char*
hopper 的名称。 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日