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

> Crea un vale de reposición de servidor de PlayFab Multiplayer para que un servidor de juego con plazas libres pueda emparejarse con jugadores adicionales de una cola de emparejamiento.

Crea un vale de reposición de servidor.

## Sintaxis

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

### Parámetros

**`handle`**   PFMultiplayerHandle

El identificador de la instancia de la API PFMultiplayer.

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

La entidad de servidor.

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

La configuración del vale de reposición.

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

Un valor de contexto opcional del tamaño de un puntero, definido por la aplicación, que se puede usar para asociar el cambio de estado de finalización a esta llamada.

**`ticket`**   PFMatchmakingTicketHandle\*\
*salida asignada por la biblioteca*

El objeto de vale resultante.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentarios

Para usar esta característica, debe definir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS antes de incluir PFMatchmaking.h. <br /><br /> La biblioteca envía de forma automática y asincrónica un vale de reposición de servidor al servicio de emparejamiento. Cada vez que cambia el estado del vale, se proporciona un [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange). El estado del vale se puede consultar en cualquier momento mediante [PFMatchmakingTicketGetStatus()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetstatus). El vale comienza inmediatamente en el estado `PFMatchmakingTicketStatus::Creating`.   <br /><br /> Cuando el vale se completa, se proporciona un [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange). En ese momento, se encuentra una coincidencia para el vale de reposición o el vale se detuvo debido a un error. Si se realiza correctamente, la coincidencia que se encontró se puede consultar mediante [PFMatchmakingTicketGetMatch()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetmatch). El campo `regionPreferences` de [PFMatchmakingMatchDetails](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails) solo contiene la región en la que se encuentra el servidor.   <br /><br /> Si la creación del vale produce un error porque ya hay demasiados vales para los usuarios especificados en la configuración, la biblioteca cancela de forma transparente esos vales pendientes y, después, vuelve a intentar la creación del vale.   <br /><br /> Esta función requiere que se haya realizado una llamada previa a [PFMultiplayerSetEntityToken()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken) para establecer el token de entidad del servidor de juego.

## Requisitos

**Encabezado:** PFMatchmaking.h

## Consulte también

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


## Related topics

- [Notas de la versión del SDK de C++ de PlayFab Multiplayer](/es/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Uso de vales de reposición de servidor - Multiplayer SDK](/es/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [Información general de la API de C/C++ de PFMultiplayer - PFMatchmaking.h](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [CreateServerBackfillTicket](/es/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PFMatchmakingServerBackfillTicketConfiguration](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingserverbackfillticketconfiguration.md)