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_cXblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent
