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

> Cria um tíquete de preenchimento de vagas do servidor do PlayFab Multiplayer para que um servidor de jogo com vagas abertas possa ser combinado com jogadores adicionais de uma fila de matchmaking.

Cria um tíquete de preenchimento de vagas do servidor.

## Sintaxe

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

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

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

A entidade de servidor.

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

A configuração do tíquete de preenchimento de vagas.

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

Para usar este recurso, você precisa definir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS antes de incluir PFMatchmaking.h. <br /><br /> A biblioteca envia automática e assincronamente um tíquete de preenchimento de vagas do servidor ao 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::Creating`.   <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 para o tíquete de preenchimento de vagas 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). O `regionPreferences` em [PFMatchmakingMatchDetails](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails) contém apenas a região em que o servidor está localizado.   <br /><br /> Se a criação do tíquete falhar porque já existem tíquetes demais para os usuários especificados na configuração, a biblioteca cancelará de forma transparente esses tíquetes pendentes e tentará criar o tíquete novamente.   <br /><br /> Esta função exige que uma chamada anterior a [PFMultiplayerSetEntityToken()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken) tenha sido feita para definir o token de entidade do servidor de jogo.

## Requisitos

**Cabeçalho:** PFMatchmaking.h

## Confira também

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


## Related topics

- [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)
- [Usando tíquetes de preenchimento de servidor - Multiplayer SDK](/pt-BR/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [Visão geral da API C/C++ do PFMultiplayer – PFMatchmaking.h](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Create Server Backfill Ticket](/api-reference/matchmaking/create-server-backfill-ticket.md)
- [CreateServerBackfillTicket](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)