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

# XblMatchmakingCreateMatchTicketAsync

> XblMatchmakingCreateMatchTicketAsync

# XblMatchmakingCreateMatchTicketAsync

매치메이킹 요청을 서버에 전송하고 티켓 ID가 포함된 일치 티켓을 반환합니다. 결과를 가져오려면 완료 시 XblMatchmakingCreateMatchTicketResult를 호출하세요.

## Syntax

```cpp theme={null}
HRESULT XblMatchmakingCreateMatchTicketAsync(  
         XblContextHandle xboxLiveContext,  
         XblMultiplayerSessionReference ticketSessionReference,  
         const char* matchmakingServiceConfigurationId,  
         const char* hopperName,  
         const uint64_t ticketTimeout,  
         XblPreserveSessionMode preserveSession,  
         const char* ticketAttributesJson,  
         XAsyncBlock* asyncBlock  
)  
```

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

로컬 사용자의 XBOX live 컨텍스트입니다.

*ticketSessionReference*   \_In\_\
Type: [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

일치에 사용할 멀티플레이어 세션입니다.

*matchmakingServiceConfigurationId*   \_In\_\
Type: char\*

일치에 대한 서비스 구성 ID입니다.

*hopperName*   \_In\_\
Type: char\*

호퍼의 이름입니다.

*ticketTimeout*   \_In\_\
Type: uint64\_t

플레이어가 세션에 참여하기 위해 기다리는 최대 시간입니다.

*preserveSession*   \_In\_\
Type: [XblPreserveSessionMode](/reference/live/xsapi-c/matchmaking_c/enums/xblpreservesessionmode)

세션을 보존해야 하는지 여부를 나타냅니다.

*ticketAttributesJson*   \_In\_\
Type: char\*

세션에 대한 티켓 특성입니다. (선택 사항)

*asyncBlock*   \_In\_\
Type: XAsyncBlock\*

이 작업의 AsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업의 HRESULT 반환 코드입니다.

## Remarks

일치 티켓 개체에는 티켓 ID 및 대기 시간과 같은 서버에서 반환된 정보가 포함되며, 티켓 데이터 개체의 타이틀 지정 데이터 복사본도 포함됩니다.

## REST Call

V103 POST /serviceconfigs/{serviceConfigId}/hoppers/{hopperName}을(를) 호출합니다.

## Requirements

**Header:** matchmaking\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[matchmaking\_c](/reference/live/xsapi-c/matchmaking_c/matchmaking_c_members)


## Related topics

- [XblMatchmakingCreateMatchTicketResult](/ko/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakingcreatematchticketresult.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [SmartMatch 매치메이킹 사용](/ko/services/xbox-services/multiplayer/matchmaking/concepts/live-matchmaking-how-tos.md)
- [파트너 센터에서 매치메이킹 구성](/ko/services/xbox-services/multiplayer/matchmaking/config/live-matchmaking-config.md)
- [멀티플레이어 작업](/ko/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)