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

# PFMultiplayerCreateServerBackfillTicket

> Crée un ticket de remplissage serveur PlayFab Multiplayer afin qu'un serveur de jeu disposant de places libres puisse être associé à des joueurs supplémentaires issus d'une file d'attente de matchmaking.

Crée un ticket de remplissage serveur.

## Syntaxe

```cpp theme={null}
HRESULT PFMultiplayerCreateServerBackfillTicket(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const PFMatchmakingServerBackfillTicketConfiguration* configuration,  
    void* asyncContext,  
    PFMatchmakingTicketHandle* ticket  
)  
```

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

**`server`**   [PFEntityKey\*](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

Entité serveur.

**`configuration`**   [PFMatchmakingServerBackfillTicketConfiguration\*](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingserverbackfillticketconfiguration)

Configuration du ticket de remplissage.

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

Pour utiliser cette fonctionnalité, vous devez définir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS avant d'inclure PFMatchmaking.h. <br /><br /> La bibliothèque soumet automatiquement et de manière asynchrone un ticket de remplissage serveur au 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::Creating`.   <br /><br /> Lorsque le ticket est terminé, un [PFMatchmakingTicketStatusChangedStateChange](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange) est fourni. À ce stade, une partie a été trouvée pour le ticket de remplissage 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). Le champ `regionPreferences` de [PFMatchmakingMatchDetails](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails) ne contient que la région dans laquelle se trouve le serveur.   <br /><br /> Si la création du ticket échoue parce qu'il existe déjà trop de tickets pour les utilisateurs spécifiés dans la configuration, la bibliothèque annule de manière transparente ces tickets en attente, puis retente la création du ticket.   <br /><br /> Cette fonction nécessite qu'un appel précédent à [PFMultiplayerSetEntityToken()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken) ait été effectué pour définir le jeton d'entité du serveur de jeu.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [Utilisation des tickets de backfill de serveur - SDK Multiplayer](/fr/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [Notes de version du SDK C++ PlayFab Multiplayer](/fr/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Vue d'ensemble de l'API C/C++ PFMultiplayer - PFMatchmaking.h](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Create Server Backfill Ticket](/api-reference/matchmaking/create-server-backfill-ticket.md)
- [CreateServerBackfillTicket](/fr/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)