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

# XblMultiplayerManagerLobbySessionSetProperties

> XblMultiplayerManagerLobbySessionSetProperties

# XblMultiplayerManagerLobbySessionSetProperties

设置大厅会话的自定义属性的值。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionSetProperties(  
         const char* name,  
         const char* valueJson,  
         void* context  
)  
```

### 参数

*name*   \_In\_z\_\
类型：char\*

要设置的自定义属性的名称。

*valueJson*   \_In\_z\_\
类型：char\*

要分配给属性的值（JSON 字符串形式）。

*context*   \_In\_opt\_\
类型：void\*

可选。用于将 [XblMultiplayerEvent](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md) 与发起调用相关联的应用程序定义的数据。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数用于设置大厅会话的自定义属性的值（表示为 JSON 字符串）。自定义属性可以随时更改。调用 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 时，更改将以批处理方式写入服务。如果自定义属性在设备之间共享，或者可能同时由多个设备更新，请使用 [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md) 函数更改自定义属性。否则，可以使用此函数更改自定义属性。\
此函数的结果作为事件类型设置为 `XblMultiplayerEventType::SessionPropertyWriteCompleted` 的多人游戏事件传递。可以调用 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 检索多人游戏事件。

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerLobbySessionSetSynchronizedHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md)\
[XblMultiplayerEvent](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md)


## Related topics

- [XblMultiplayerManagerLobbySessionPropertiesJson](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionpropertiesjson.md)
- [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md)
- [使用 Multiplayer Manager 与好友玩多人游戏](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-friends.md)
- [使用多人游戏管理器通过 SmartMatch 启用查找多人游戏](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Manager API 概述](https://docs.xbox.com/zh-CN/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)