Skip to main content

XblMatchmakingCreateMatchTicketAsync

Envia uma solicitação de matchmaking ao servidor e retorna o tíquete de partida com uma ID de tíquete. Chame XblMatchmakingCreateMatchTicketResult após a conclusão para obter o resultado.

Sintaxe

Parâmetros

xboxLiveContext   _In_
Tipo: XblContextHandle
Contexto do XBOX Live para o usuário local. ticketSessionReference   _In_
Tipo: XblMultiplayerSessionReference
A sessão multijogador a ser usada para a partida. matchmakingServiceConfigurationId   _In_
Tipo: char*
A ID de configuração de serviço para a partida. hopperName   _In_
Tipo: char*
O nome do hopper. ticketTimeout   _In_
Tipo: uint64_t
O tempo máximo de espera para que os jogadores entrem na sessão. preserveSession   _In_
Tipo: XblPreserveSessionMode
Indica se a sessão deve ser preservada. ticketAttributesJson   _In_
Tipo: char*
Os atributos do tíquete para a sessão. (Opcional) asyncBlock   _In_
Tipo: XAsyncBlock*
O AsyncBlock para esta operação.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

Comentários

O objeto de tíquete de partida contém informações retornadas pelo servidor, como a ID do tíquete e o tempo de espera, além de cópias dos dados especificados pelo título do objeto de dados do tíquete.

Chamada REST

Chama V103 POST /serviceconfigs//hoppers/

Requisitos

Cabeçalho: matchmaking_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

matchmaking_c
Last modified on October 6, 2026