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

> Fait rejoindre un ticket de matchmaking PlayFab Multiplayer existant à un ou plusieurs utilisateurs locaux, à l'aide d'un ID de ticket et d'un nom de file d'attente partagés par le créateur initial du ticket.

Fait rejoindre un ticket de matchmaking à un ou plusieurs utilisateurs locaux à l'aide d'un ID de ticket et d'un nom de file d'attente.

## Syntaxe

```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  
)  
```

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

**`localUserCount`**   uint32\_t

Nombre d'utilisateurs locaux devant rejoindre le ticket.

**`localUsers`**   [PFEntityKey\*](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\
*tableau d'entrée de taille `localUserCount`*

Tableau des utilisateurs locaux devant rejoindre le ticket.

**`localUserAttributes`**   char\*\
*tableau d'entrée de taille `localUserCount`*

Tableau des chaînes d'attributs des utilisateurs locaux. Il doit y avoir une chaîne d'attributs pour chaque utilisateur local. Chaque chaîne d'attributs doit être soit une chaîne vide, soit un objet JSON sérialisé. Par exemple, `{"player_color":"blue","player_role":"tank"}`.

**`ticketId`**   char\*\
*se termine par un caractère null*

ID du ticket à rejoindre.

**`queueName`**   char\*\
*se termine par un caractère null*

File d'attente à laquelle appartient le ticket.

**`asyncContext`**   void\*\
*facultatif*

Valeur de contexte facultative, définie par l'application et de la taille d'un pointeur, qui peut être utilisée pour associer le changement d'état d'achèvement à cet appel.

**`ticket`**   PFMatchmakingTicketHandle\*\
*sortie allouée par la bibliothèque*

Objet ticket obtenu.

### Valeur renvoyée

Type : HRESULT

`S_OK` si l'appel a réussi, ou un code d'erreur dans le cas contraire. La forme lisible du code d'erreur peut être récupérée via [PFMultiplayerGetErrorMessage()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Remarques

La bibliothèque soumet automatiquement et de manière asynchrone tous les utilisateurs locaux spécifiés afin qu'ils rejoignent le ticket auprès du service de matchmaking. Chaque fois que l'état du ticket change, un [PFMatchmakingTicketStatusChangedStateChange](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange) est fourni. L'état du ticket peut être interrogé à tout moment via [PFMatchmakingTicketGetStatus()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetstatus). Le ticket démarre immédiatement à l'état `PFMatchmakingTicketStatus::Joining`. <br /><br /> Lorsque le ticket se termine, un [PFMatchmakingTicketStatusChangedStateChange](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange) est fourni. À ce stade, une partie a été trouvée ou le ticket s'est arrêté en raison d'un échec. En cas de réussite, la partie trouvée peut être interrogée via [PFMatchmakingTicketGetMatch()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetmatch).   <br /><br /> Si la création du ticket échoue parce qu'il existe déjà trop de tickets pour les utilisateurs spécifiés, la bibliothèque annule de manière transparente ces tickets en attente, puis retente la création du ticket.

## Configuration requise

**En-tête :** PFMatchmaking.h

## Voir aussi

[Membres de PFMatchmaking](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)


## Related topics

- [PFMatchmakingTicketStatus](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/enums/pfmatchmakingticketstatus.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMatchmakingTicketConfiguration](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketconfiguration.md)
- [PFMultiplayerCreateMatchmakingTicket](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreatematchmakingticket.md)
- [Démarrage rapide du SDK Matchmaking](/fr/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)