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

# PFMatchmakingTicketSetCustomContext

> Anexa um valor de contexto personalizado e opcional, do tamanho de um ponteiro, a um tíquete de matchmaking do PlayFab Multiplayer para recuperação posterior pelo aplicativo.

Configura um valor de contexto personalizado e opcional, do tamanho de um ponteiro, com este objeto de tíquete.

## Sintaxe

```cpp theme={null}
HRESULT PFMatchmakingTicketSetCustomContext(  
    PFMatchmakingTicketHandle ticket,  
    void* customContext  
)  
```

### Parâmetros

**`ticket`**   PFMatchmakingTicketHandle

O identificador do tíquete de matchmaking.

**`customContext`**   void\*\
*opcional*

Um valor arbitrário, do tamanho de um ponteiro, a ser armazenado com o objeto de jogador.

### Valor retornado

Tipo: HRESULT

`S_OK` se a configuração do contexto personalizado 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

O contexto personalizado normalmente é usado como um "atalho" que simplifica o acesso à memória local e específica do título associada ao tíquete de matchmaking, sem exigir uma pesquisa de mapeamento. O valor é recuperado usando o método [PFMatchmakingTicketGetCustomContext()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext.md). \
\
 Qualquer valor configurado é tratado como opaco pela biblioteca e só é válido no dispositivo local; ele não é transmitido pela rede.

## 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)\
[PFMatchmakingTicketGetCustomContext](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext.md)


## Related topics

- [PFMatchmakingTicketGetCustomContext](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext.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)
- [MatchmakingTicket.Context](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Context.md)
- [Join Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/join-matchmaking-ticket.md)