Skip to main content

XblMultiplayerManagerLobbySessionSetProperties

设置大厅会话的自定义属性的值。

语法

参数

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

返回值

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

备注

此函数用于设置大厅会话的自定义属性的值(表示为 JSON 字符串)。自定义属性可以随时更改。调用 XblMultiplayerManagerDoWork 时,更改将以批处理方式写入服务。如果自定义属性在设备之间共享,或者可能同时由多个设备更新,请使用 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 函数更改自定义属性。否则,可以使用此函数更改自定义属性。
此函数的结果作为事件类型设置为 XblMultiplayerEventType::SessionPropertyWriteCompleted 的多人游戏事件传递。可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。

要求

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

另请参阅

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