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

# PFMatchmakingTicketCancel

> 進行中の PlayFab Multiplayer マッチメイキング チケットをキャンセルし、マッチの検索を停止して、チケットをキャンセル済みステータスに移行させます。

チケットをキャンセルします。

## 構文

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

### パラメーター

**`ticket`**   PFMatchmakingTicketHandle

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

### 戻り値

型: HRESULT

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

## 解説

このメソッドは、このマッチメイキング チケットをキャンセルする非同期操作をキューに登録します。成功すると、チケットがキャンセルされたことを示す [PFMatchmakingTicketCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange.md) が提供されます。\
\
 このメソッドは、チケットのキャンセルを保証するものではありません。キャンセルの処理前にチケットが完了する場合や、ネットワークまたはサービス エラーによりキャンセル要求が失敗する場合があります。キャンセルの試行が失敗しても再試行可能な場合、ライブラリはキャンセルの再試行を続行します。それ以外の場合、チケットが失敗したことを示す [PFMatchmakingTicketCompletedStateChange](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange.md) が提供されます。

## 要件

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

## 関連項目

[PFMatchmaking のメンバー](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)


## Related topics

- [Matchmaking SDK quickstart](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [PFMultiplayer C/C++ API の概要 - PFMatchmaking.h](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [サーバー バックフィル チケットの使用 - Multiplayer SDK](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [PlayFab Multiplayer C++ SDK リリース ノート](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Cancel Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/cancel-matchmaking-ticket.md)