> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMatchmakingCreateMatchTicketAsync

> XblMatchmakingCreateMatchTicketAsync

# 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

```cpp theme={null}
HRESULT XblMatchmakingCreateMatchTicketAsync(  
         XblContextHandle xboxLiveContext,  
         XblMultiplayerSessionReference ticketSessionReference,  
         const char* matchmakingServiceConfigurationId,  
         const char* hopperName,  
         const uint64_t ticketTimeout,  
         XblPreserveSessionMode preserveSession,  
         const char* ticketAttributesJson,  
         XAsyncBlock* asyncBlock  
)  
```

### Parâmetros

*xboxLiveContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live para o usuário local.

*ticketSessionReference*   \_In\_\
Tipo: [XblMultiplayerSessionReference](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/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](/pt-BR/reference/live/xsapi-c/matchmaking_c/enums/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/{serviceConfigId}/hoppers/{hopperName}

## Requisitos

**Cabeçalho:** matchmaking\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[matchmaking\_c](/pt-BR/reference/live/xsapi-c/matchmaking_c/matchmaking_c_members)


## Related topics

- [XblMatchmakingCreateMatchTicketAsync](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakingcreatematchticketasync.md)
- [XblMatchmakingCreateMatchTicketResult](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakingcreatematchticketresult.md)