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

# XblMultiplayerManagerGameSessionSetProperties

> XblMultiplayerManagerGameSessionSetProperties

# XblMultiplayerManagerGameSessionSetProperties

设置游戏会话的自定义属性的值。

## 语法

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

### 参数

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

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

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

要分配给该属性的值，以 JSON 字符串形式。

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

可选。用于将 [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 关联到发起调用的应用程序定义的数据。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数将游戏会话的自定义属性设置为以 JSON 字符串形式表示的值。可以随时更改自定义属性。当调用 [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 时，更改将被批处理并写入服务。如果自定义属性在多个设备之间共享，或可能同时由多个设备更新，请使用 [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties) 函数来更改自定义属性。否则，你可以使用此函数来更改自定义属性。

## 要求

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

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

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost)


## Related topics

- [XblMultiplayerManagerGameSessionPropertiesJson](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionpropertiesjson.md)
- [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md)
- [Multiplayer Manager API 概述](/zh-CN/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerManagerJoinGame](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)
- [XblMultiplayerManagerJoinGameFromLobby](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)