> ## 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](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 與起始呼叫建立關聯。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會設定大廳工作階段的主機。使用此函式可確保不可部分完成性，並解決多個裝置同時嘗試設定主機時的任何衝突。<br />如果因衝突而發生競爭情況，服務可能會拒絕設定主機的要求。如果要求遭拒，服務會傳回 `HTTP_E_STATUS_PRECOND_FAILED`。如果發生衝突，請重新評估是否需要變更主機，並視需要再次呼叫此函式以重新提交要求。<br />此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為 `XblMultiplayerEventType::SynchronizedHostWriteCompleted`。您可以呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 來擷取多人遊戲事件。請注意，主機裝置權杖是從工作階段成員的安全裝置位址產生，因此在呼叫此方法之前，請確定已為所需的主機設定安全裝置位址。

## 需求

**標頭：** multiplayer\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

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