> ## 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.

# PFMultiplayerJoinMatchmakingTicketFromId

> Faz um ou mais usuários locais ingressarem em um tíquete de matchmaking existente do PlayFab Multiplayer usando uma ID de tíquete e um nome de fila compartilhados pelo criador inicial do tíquete.

Faz um ou vários usuários locais ingressarem em um tíquete de matchmaking usando uma ID de tíquete e um nome de fila.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerJoinMatchmakingTicketFromId(  
    PFMultiplayerHandle handle,  
    uint32_t localUserCount,  
    const PFEntityKey* localUsers,  
    const char* localUserAttributes,  
    const char* ticketId,  
    const char* queueName,  
    void* asyncContext,  
    PFMatchmakingTicketHandle* ticket  
)  
```

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

**`localUserCount`**   uint32\_t

A contagem de usuários locais que ingressarão no tíquete.

**`localUsers`**   [PFEntityKey\*](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\
*matriz de entrada de tamanho `localUserCount`*

A matriz de usuários locais que ingressarão no tíquete.

**`localUserAttributes`**   char\*\
*matriz de entrada de tamanho `localUserCount`*

A matriz de cadeias de caracteres de atributos dos usuários locais. Deve haver uma cadeia de caracteres de atributo para cada usuário local. Cada cadeia de caracteres de atributo deve ser uma cadeia de caracteres vazia ou um objeto JSON serializado. Por exemplo, `{"player_color":"blue","player_role":"tank"}`.

**`ticketId`**   char\*\
*terminada em nulo*

A ID do tíquete no qual ingressar.

**`queueName`**   char\*\
*terminada em nulo*

A fila à qual o tíquete pertence.

**`asyncContext`**   void\*\
*opcional*

Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

**`ticket`**   PFMatchmakingTicketHandle\*\
*saída alocada pela biblioteca*

O objeto de tíquete resultante.

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentários

A biblioteca envia automática e assincronamente todos os usuários locais especificados para ingressar no tíquete no serviço de matchmaking. Sempre que o status do tíquete muda, uma [PFMatchmakingTicketStatusChangedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange) é fornecida. O status do tíquete pode ser consultado a qualquer momento por meio de [PFMatchmakingTicketGetStatus()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetstatus). O tíquete começa imediatamente no estado `PFMatchmakingTicketStatus::Joining`. <br /><br /> Quando o tíquete é concluído, uma [PFMatchmakingTicketStatusChangedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange) é fornecida. Nesse ponto, uma partida foi encontrada ou o tíquete parou devido a uma falha. Em caso de êxito, a partida encontrada pode ser consultada por meio de [PFMatchmakingTicketGetMatch()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetmatch).   <br /><br /> Se a criação do tíquete falhar porque já existem tíquetes demais para os usuários especificados, a biblioteca cancelará de forma transparente esses tíquetes pendentes e tentará criar o tíquete novamente.

## Requisitos

**Cabeçalho:** PFMatchmaking.h

## Confira também

[Membros do PFMatchmaking](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)


## Related topics

- [PFMatchmakingTicketStatus](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/enums/pfmatchmakingticketstatus.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMultiplayerCreateMatchmakingTicket](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreatematchmakingticket.md)
- [PFMatchmakingTicketConfiguration](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketconfiguration.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)