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

# PFMatchmakingTicketCancel

> 진행 중인 PlayFab Multiplayer 매치메이킹 티켓을 취소하고 매치 검색을 중지하며 티켓을 취소됨 상태로 전환합니다.

티켓을 취소합니다.

## 구문

```cpp theme={null}
HRESULT PFMatchmakingTicketCancel(  
    PFMatchmakingTicketHandle ticket  
)  
```

### 매개 변수

**`ticket`**   PFMatchmakingTicketHandle

매치메이킹 티켓의 핸들입니다.

### 반환 값

형식: HRESULT

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

## 설명

이 메서드는 이 매치메이킹 티켓을 취소하기 위한 비동기 작업을 큐에 추가합니다. 성공하면 티켓이 취소되었음을 나타내는 [PFMatchmakingTicketCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange)가 제공됩니다. <br /><br /> 이 메서드는 티켓이 취소된다는 것을 보장하지 않습니다. 취소가 처리되기 전에 티켓이 완료되거나 네트워킹 또는 서비스 오류로 인해 취소 요청이 실패할 수 있습니다. 취소 시도가 실패했지만 재시도할 수 있는 경우 라이브러리는 계속해서 취소를 재시도합니다. 그렇지 않으면 티켓이 실패했음을 나타내는 [PFMatchmakingTicketCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange)가 제공됩니다.

## 요구 사항

**헤더:** PFMatchmaking.h

## 참고 항목

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


## Related topics

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