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

# PFLobbySetCustomContext

> PFLobbySetCustomContext 参考，用于通过 PlayFab Multiplayer C++ SDK API 将应用定义的指针上下文值附加到 PlayFab 大厅句柄。

为此大厅对象配置一个可选的自定义指针大小的上下文值。

## 语法

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

### 参数

**`lobby`**   PFLobbyHandle

大厅的句柄。

**`customContext`**   void\*\
*optional*

要与玩家对象一起存储的任意指针大小的值。

### 返回值

类型：HRESULT

如果配置自定义上下文成功，则为 `S_OK`；否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 检索错误代码的可读形式。

## 备注

自定义上下文通常用作“快捷方式”，可在无需映射查找的情况下简化访问与大厅关联的本地、标题特定的内存。可使用 [PFLobbyGetCustomContext()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext) 方法检索此值。<br /><br /> 库将任何配置的值视为不透明数据，仅在本地设备上有效；它不会通过网络传输。

## 要求

**头文件：** PFLobby.h

## 另请参阅

[PFLobby 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)\
[PFLobbyGetCustomContext](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext)


## Related topics

- [PFLobbyGetCustomContext](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetcustomcontext.md)
- [PFMatchmakingTicketSetCustomContext](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmatchmakingticketsetcustomcontext.md)
- [chat_user::set_custom_user_context](/zh-CN/reference/chat/gamechat2/classes/chat_user/methods/chat_user_set_custom_user_context.md)
- [pre_encode_audio_stream::set_custom_stream_context](/zh-CN/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_custom_stream_context.md)
- [PartyInvitation::SetCustomContext](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyInvitation/methods/partyinvitation_setcustomcontext.md)