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_cXblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent
