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

# PFLobbySetCustomContext

> Referência de PFLobbySetCustomContext para anexar um valor de contexto de ponteiro definido pelo aplicativo a um identificador de lobby do PlayFab usando as APIs do SDK C++ do PlayFab Multiplayer.

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

## Sintaxe

```cpp theme={null}
HRESULT PFLobbySetCustomContext(  
    PFLobbyHandle lobby,  
    void* customContext  
)  
```

### Parâmetros

**`lobby`**   PFLobbyHandle

O identificador do lobby.

**`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 lobby, sem exigir uma pesquisa de mapeamento. O valor é recuperado usando o método [PFLobbyGetCustomContext()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext.md). \
\
&#x20;Qualquer valor configurado é tratado como opaco pela biblioteca e só é válido no dispositivo local; ele não é transmitido pela rede.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)\
[PFLobbyGetCustomContext](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext.md)


## Related topics

- [PFLobbyGetCustomContext](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext.md)
- [Visão geral da API C/C++ do PFMultiplayer – PFLobby.h](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PFMatchmakingTicketSetCustomContext](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketsetcustomcontext.md)
- [set_custom_user_context](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_user/methods/chat_user_set_custom_user_context.md)
- [pre_encode_audio_stream::set_custom_stream_context](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_custom_stream_context.md)
