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

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

> XblMultiplayerManagerGameSessionSetSynchronizedProperties

# XblMultiplayerManagerGameSessionSetSynchronizedProperties

使用 `XblMultiplayerSessionWriteMode::SynchronizedUpdate` 設定遊戲工作階段的自訂屬性值。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerManagerGameSessionSetSynchronizedProperties(  
         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-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md) 與起始呼叫相互關聯。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會設定遊戲工作階段的自訂屬性值 (以 JSON 字串表示)。自訂屬性可以隨時變更。如果自訂屬性在裝置之間共用，或可能同時由多個裝置更新，請使用此函式來確保不可部分完成性，並在變更這些自訂屬性的值時解決裝置之間的衝突。如果自訂屬性未在裝置之間共用，請改用 [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md) 函式來變更該自訂屬性的值。\
如果因衝突而發生競爭情形，服務可能會拒絕變更自訂屬性的要求。如果要求遭到拒絕，服務會傳回 `HTTP_E_STATUS_PRECOND_FAILED`。如果發生衝突，請重新評估是否需要變更自訂屬性，並視需要再次呼叫此函式以重新提交要求。\
此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)\
[XblMultiplayerEvent](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md)


## Related topics

- [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md)
- [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md)
- [XblMultiplayerManagerGameSessionPropertiesJson](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionpropertiesjson.md)
- [XblMultiplayerManagerJoinGame](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md)
- [多人遊戲管理員 API 概觀](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)