> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerLobbySessionSetSynchronizedHost

> XblMultiplayerManagerLobbySessionSetSynchronizedHost

# XblMultiplayerManagerLobbySessionSetSynchronizedHost

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

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionSetSynchronizedHost(  
         const char* deviceToken,  
         void* context  
)  
```

### 参数

*deviceToken*   \_In\_\
类型：char\*

主机的设备令牌。

*context*   \_In\_opt\_\
类型：void\*

可选。用于将 [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 与发起调用相关联的应用程序定义的数据。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties)\
[XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent)\
[XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetlocalmemberconnectionaddress)


## Related topics

- [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md)
- [XblMultiplayerManagerLobbySessionIsHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerLobbySessionSetProperties](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetproperties.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerJoinLobby](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)