XblMultiplayerManagerLobbySessionSetSynchronizedProperties
使用XblMultiplayerSessionWriteMode::SynchronizedUpdate 设置大厅会话的自定义属性的值。
语法
参数
name _In_z_类型：char* 要设置的自定义属性的名称。 valueJson _In_z_
类型：char* 要分配给属性的值（JSON 字符串形式）。 context _In_opt_
类型：void* 可选。用于将 XblMultiplayerEvent 与发起调用相关联的应用程序定义的数据。
返回值
类型：HRESULT 此 API 操作的 HRESULT 返回代码。备注
此函数用于设置大厅会话的自定义属性的值（表示为 JSON 字符串）。自定义属性可以随时更改。如果自定义属性在设备之间共享，或者可能同时由多个设备更新，请使用此函数来确保原子性，并解决更改这些自定义属性值时设备之间的任何冲突。如果自定义属性不在设备之间共享，请改为使用 XblMultiplayerManagerLobbySessionSetProperties 函数更改该自定义属性的值。如果因冲突产生争用条件，服务可能会拒绝更改自定义属性的请求。如果请求被拒绝，服务将返回
HTTP_E_STATUS_PRECOND_FAILED。如果发生冲突，请重新评估更改自定义属性的需求，并根据需要再次调用此函数以重新提交请求。此函数的结果作为事件类型设置为
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted 的多人游戏事件传递。可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。
要求
头文件： multiplayer_manager_c.h 库： Microsoft.Xbox.Services.14x.GDK.C.lib另请参阅
multiplayer_manager_cXblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent