Skip to main content

XblMatchmakingCreateMatchTicketAsync

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

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
로컬 사용자의 XBOX live 컨텍스트입니다. ticketSessionReference   _In_
Type: XblMultiplayerSessionReference
일치에 사용할 멀티플레이어 세션입니다. matchmakingServiceConfigurationId   _In_
Type: char*
일치에 대한 서비스 구성 ID입니다. hopperName   _In_
Type: char*
호퍼의 이름입니다. ticketTimeout   _In_
Type: uint64_t
플레이어가 세션에 참여하기 위해 기다리는 최대 시간입니다. preserveSession   _In_
Type: XblPreserveSessionMode
세션을 보존해야 하는지 여부를 나타냅니다. ticketAttributesJson   _In_
Type: char*
세션에 대한 티켓 특성입니다. (선택 사항) asyncBlock   _In_
Type: XAsyncBlock*
이 작업의 AsyncBlock입니다.

Return value

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

Remarks

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

REST Call

V103 POST /serviceconfigs//hoppers/을(를) 호출합니다.

Requirements

Header: matchmaking_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

matchmaking_c
마지막 수정일 2026년 8월 24일