Skip to main content

XblMultiplayerManagerGameSessionSetSynchronizedProperties

使用 XblMultiplayerSessionWriteMode::SynchronizedUpdate 设置游戏会话的自定义属性的值。

语法

参数

name   _In_z_
类型:char*
要设置的自定义属性的名称。 valueJson   _In_z_
类型:char*
要分配给该属性的值,以 JSON 字符串形式。 context   _In_opt_
类型:void*
可选。用于将 XblMultiplayerEvent 关联到发起调用的应用程序定义的数据。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

此函数将游戏会话的自定义属性设置为以 JSON 字符串形式表示的值。可以随时更改自定义属性。如果自定义属性在多个设备之间共享,或可能同时由多个设备更新,请使用此函数以确保原子性,并在更改这些自定义属性的值时解决设备之间的任何冲突。如果自定义属性不跨设备共享,请改用 XblMultiplayerManagerGameSessionSetProperties 函数更改该自定义属性的值。
如果由于冲突而发生争用情况,服务可能会拒绝更改自定义属性的请求。如果请求被拒绝,服务将返回 HTTP_E_STATUS_PRECOND_FAILED。如果发生冲突,请重新评估更改自定义属性的需要,如有必要,再次调用此函数以重新提交请求。
此函数的结果作为多人游戏事件传递,事件类型设置为 XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。

要求

头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_manager_c
XblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent
最后修改于 2026年8月13日