Skip to main content

XblMultiplayerManagerLobbySessionSetSynchronizedHost

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
XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
最終更新日 2026年8月13日