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

> Cancela um tíquete de matchmaking do PlayFab Multiplayer em andamento, interrompendo a busca por uma partida e fazendo o tíquete passar para o status cancelado.

Cancela o tíquete.

## Sintaxe

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

### Parâmetros

**`ticket`**   PFMatchmakingTicketHandle

O identificador do tíquete de matchmaking.

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentários

Este método enfileira uma operação assíncrona para cancelar este tíquete de matchmaking. Em caso de êxito, uma [PFMatchmakingTicketCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange.md) será fornecida indicando que o tíquete foi cancelado. \
\
 Este método não garante que o tíquete será cancelado. O tíquete pode ser concluído antes que o cancelamento possa ser processado, ou a solicitação de cancelamento pode falhar devido a erros de rede ou do serviço. Se a tentativa de cancelamento falhar, mas puder ser repetida, a biblioteca continuará tentando o cancelamento. Caso contrário, será fornecida uma [PFMatchmakingTicketCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingticketcompletedstatechange.md) indicando que o tíquete falhou.

## Requisitos

**Cabeçalho:** PFMatchmaking.h

## Confira também

[Membros do PFMatchmaking](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)


## Related topics

- [Início rápido do SDK de Matchmaking](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Usando tíquetes de preenchimento de servidor - Multiplayer SDK](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/matchmaking/backfill-tickets-multiplayer-sdk.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Visão geral da API C/C++ do PFMultiplayer – PFMatchmaking.h](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Cancel Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/cancel-matchmaking-ticket.md)