XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerSessionWriteMode::SynchronizedUpdate を使用して、ロビー セッションのカスタム プロパティの値を設定します。
構文
パラメーター
name _In_z_型: char* 設定するカスタム プロパティの名前。 valueJson _In_z_
型: char* プロパティに割り当てる値 (JSON 文字列)。 context _In_opt_
型: void* 省略可能。XblMultiplayerEvent を発生させた呼び出しと関連付けるための、アプリケーション定義データ。
戻り値
型: HRESULT この API 操作の HRESULT 戻りコード。解説
この関数は、ロビー セッションのカスタム プロパティの値を JSON 文字列として設定します。カスタム プロパティはいつでも変更できます。カスタム プロパティが複数のデバイス間で共有されていたり、複数のデバイスから同時に更新される可能性がある場合は、この関数を使用することで原子性が保証され、これらのカスタム プロパティの値を変更する際のデバイス間の競合を解決できます。カスタム プロパティが複数のデバイス間で共有されていない場合は、代わりに XblMultiplayerManagerLobbySessionSetProperties 関数を使用して、そのカスタム プロパティの値を変更してください。競合による競合状態が発生した場合、サービスはカスタム プロパティの変更要求を拒否することがあります。要求が拒否された場合、サービスは
HTTP_E_STATUS_PRECOND_FAILED を返します。競合が発生した場合は、カスタム プロパティを変更する必要性を再評価し、必要であればこの関数を再度呼び出して要求を再送信してください。この関数の結果は、イベント タイプが
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted に設定されたマルチプレイヤー イベントとして配信されます。マルチプレイヤー イベントを取得するには、XblMultiplayerManagerDoWork を呼び出します。
要件
ヘッダー: multiplayer_manager_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib関連項目
multiplayer_manager_cXblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent