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

# 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()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## 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()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext). <br /><br /> 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](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)\
[PFMatchmakingTicketGetCustomContext](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext)


## Related topics

- [PFMatchmakingTicketGetCustomContext](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketgetcustomcontext.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](/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](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [MatchmakingTicket.Context](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Context.md)
- [MatchmakingTicket](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview.md)