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

# PFMatchmakingTicketGetTicketId

> PlayFab Multiplayer マッチメイキング チケットに割り当てられた一意のチケット ID を取得します。他のクライアント セッションからチケットに参加または参照するために使用されます。

チケット ID を提供します。

## 構文

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

### パラメーター

**`ticket`**   PFMatchmakingTicketHandle

マッチメイキング チケットのハンドルです。

**`id`**   char\*\*\
*ライブラリ割り当ての出力*

チケット ID です。

### 戻り値

型: HRESULT

呼び出しが成功した場合は `S_OK`、それ以外の場合はエラー コード。エラー コードを人間が読める形式で取得するには、[PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) を使用します。

## 解説

チケット ID がまだ設定されていない場合は空の文字列になります。これは、次のいずれかの状況で発生する可能性があります:

* チケットが `PFMatchmakingTicketStatus::Creating` 状態である
* チケットをマッチメイキング サービスへ送信できなかったため、チケットが `PFMatchmakingTicketStatus::Failed` 状態である
* チケットがマッチメイキング サービスへ送信される前にキャンセルされた

## 要件

**ヘッダー:** PFMatchmaking.h

## 関連項目

[PFMatchmaking のメンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)


## Related topics

- [PFMultiplayer C/C++ API overview - PFMatchmaking.h](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [PlayFab Multiplayer C++ SDK リリース ノート](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [MatchmakingTicket.TicketId](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/TicketId.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md)
- [XblMatchmakingGetMatchTicketDetailsAsync](/ja-jp/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggetmatchticketdetailsasync.md)