Skip to main content

XblMultiplayerManagerGameSessionSetSynchronizedHost

使用 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
XblMultiplayerManagerGameSessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
最后修改于 2026年8月13日