XblMultiplayerManagerLobbySessionSetSynchronizedHost

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

语法

HRESULT XblMultiplayerManagerLobbySessionSetSynchronizedHost(  
         const char* deviceToken,  
         void* context  
)  

参数

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