Skip to main content

XblMultiplayerManagerLobbySessionSetSynchronizedHost

使用 XblMultiplayerSessionWriteMode::SynchronizedUpdate 设置大厅会话的主机。

语法

参数

deviceToken   _In_
类型:char*
主机的设备令牌。 context   _In_opt_
类型:void*
可选。用于将 XblMultiplayerEvent 与发起调用相关联的应用程序定义的数据。

返回值

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

备注

此函数用于设置大厅会话的主机。使用此函数可确保原子性,并解决多个设备同时尝试设置主机时之间的任何冲突。
如果因冲突产生争用条件,服务可能会拒绝设置主机的请求。如果请求被拒绝,服务将返回 HTTP_E_STATUS_PRECOND_FAILED。如果发生冲突,请重新评估更改主机的需求,并根据需要再次调用此函数以重新提交请求。
此函数的结果作为事件类型设置为 XblMultiplayerEventType::SynchronizedHostWriteCompleted 的多人游戏事件传递。可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。请注意,主机设备令牌是从会话成员的安全设备地址生成的,因此请确保在调用此方法之前为所需主机设置了安全设备地址。

要求

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

另请参阅

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