Skip to main content

XblMultiplayerManagerLobbySessionSetProperties

ロビー セッションのカスタム プロパティの値を設定します。

構文

パラメーター

name   _In_z_
型: char*
設定するカスタム プロパティの名前。 valueJson   _In_z_
型: char*
プロパティに割り当てる値 (JSON 文字列)。 context   _In_opt_
型: void*
省略可能。XblMultiplayerEvent を発生させた呼び出しと関連付けるための、アプリケーション定義データ。

戻り値

型: HRESULT この API 操作の HRESULT 戻りコード。

解説

この関数は、ロビー セッションのカスタム プロパティの値を JSON 文字列として設定します。カスタム プロパティはいつでも変更できます。変更はバッチ処理され、XblMultiplayerManagerDoWork が呼び出されたときにサービスに書き込まれます。カスタム プロパティが複数のデバイス間で共有されていたり、複数のデバイスから同時に更新される可能性がある場合は、XblMultiplayerManagerLobbySessionSetSynchronizedProperties 関数を使用してカスタム プロパティを変更してください。それ以外の場合は、この関数を使用してカスタム プロパティを変更できます。
この関数の結果は、イベント タイプが XblMultiplayerEventType::SessionPropertyWriteCompleted に設定されたマルチプレイヤー イベントとして配信されます。マルチプレイヤー イベントを取得するには、XblMultiplayerManagerDoWork を呼び出します。

要件

ヘッダー: multiplayer_manager_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent
最終更新日 2026年8月13日