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
Last modified on October 6, 2026