> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMatchmakingTicketGetTicketId

> 다른 클라이언트 세션에서 티켓에 참여하거나 티켓을 참조하는 데 사용되는, PlayFab Multiplayer 매치메이킹 티켓에 할당된 고유한 티켓 ID를 검색합니다.

티켓 ID를 제공합니다.

## 구문

```cpp theme={null}
HRESULT PFMatchmakingTicketGetTicketId(  
    PFMatchmakingTicketHandle ticket,  
    const char** id  
)  
```

### 매개 변수

**`ticket`**   PFMatchmakingTicketHandle

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

**`id`**   char\*\*\
*라이브러리에서 할당된 출력*

티켓 ID입니다.

### 반환 값

형식: HRESULT

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

## 설명

티켓 ID가 아직 설정되지 않은 경우 빈 문자열이 됩니다. 이는 다음 조건 중 하나에서 발생할 수 있습니다.

* 티켓이 `PFMatchmakingTicketStatus::Creating` 상태입니다
* 매치메이킹 서비스에 티켓을 제출하지 못하여 티켓이 `PFMatchmakingTicketStatus::Failed` 상태입니다
* 티켓이 매치메이킹 서비스에 제출되기 전에 취소되었습니다

## 요구 사항

**헤더:** PFMatchmaking.h

## 함께 보기

[PFMatchmaking members](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)


## Related topics

- [PFMultiplayer C/C++ API 개요 - PFMatchmaking.h](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [PlayFab Multiplayer C++ SDK 릴리스 정보](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Get Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/get-matchmaking-ticket.md)
- [MatchmakingTicket.TicketId](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/TicketId.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md)