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