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

> 빈 슬롯이 있는 게임 서버가 매치메이킹 큐의 추가 플레이어와 매치될 수 있도록 PlayFab Multiplayer 서버 백필 티켓을 만듭니다.

서버 백필 티켓을 만듭니다.

## 구문

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

### 매개 변수

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 인스턴스의 핸들입니다.

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

서버 엔터티입니다.

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

백필 티켓 구성입니다.

**`asyncContext`**   void\*\
*선택 사항*

이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.

**`ticket`**   PFMatchmakingTicketHandle\*\
*라이브러리에서 할당된 출력*

결과 티켓 개체입니다.

### 반환 값

형식: HRESULT

호출에 성공한 경우 `S_OK`이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage)를 통해 검색할 수 있습니다.

## 설명

이 기능을 사용하려면 PFMatchmaking.h를 포함하기 전에 PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS를 정의해야 합니다. <br /><br /> 라이브러리는 자동으로 그리고 비동기적으로 서버 백필 티켓을 매치메이킹 서비스에 제출합니다. 티켓 상태가 변경될 때마다 [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange)가 제공됩니다. 티켓 상태는 언제든지 [PFMatchmakingTicketGetStatus()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetstatus)를 통해 쿼리할 수 있습니다. 티켓은 즉시 `PFMatchmakingTicketStatus::Creating` 상태에서 시작합니다.   <br /><br /> 티켓이 완료되면 [PFMatchmakingTicketStatusChangedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketstatuschangedstatechange)가 제공됩니다. 그 시점에 백필 티켓에 대한 매치가 발견되었거나 실패로 인해 티켓이 중지되었습니다. 성공 시, 발견된 매치는 [PFMatchmakingTicketGetMatch()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetmatch)를 통해 쿼리할 수 있습니다. [PFMatchmakingMatchDetails](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails)의 `regionPreferences`에는 서버가 위치한 지역만 포함됩니다.   <br /><br /> 구성에 지정된 사용자에 대해 이미 너무 많은 티켓이 있어 티켓 생성에 실패하는 경우, 라이브러리는 미해결 티켓을 투명하게 취소한 다음 티켓 생성을 다시 시도합니다.   <br /><br /> 이 함수는 게임 서버 엔터티 토큰을 설정하기 위해 [PFMultiplayerSetEntityToken()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken)에 대한 이전 호출이 있어야 합니다.

## 요구 사항

**헤더:** PFMatchmaking.h

## 함께 보기

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


## Related topics

- [서버 백필 티켓 사용 - Multiplayer SDK](/ko/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [PlayFab Multiplayer C++ SDK 릴리스 정보](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 개요 - PFMatchmaking.h](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [CreateServerBackfillTicket](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PFMatchmakingServerBackfillTicketConfiguration](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingserverbackfillticketconfiguration.md)