XblMultiplayerManagerGameSessionSetSynchronizedProperties
使用XblMultiplayerSessionWriteMode::SynchronizedUpdate 設定遊戲工作階段的自訂屬性值。
語法
參數
name _In_z_類型：char* 要設定的自訂屬性名稱。 valueJson _In_z_
類型：char* 要指派給屬性的值，以 JSON 字串表示。 context _In_opt_
類型：void* 選用。應用程式定義的資料，用來將 XblMultiplayerEvent 與起始呼叫相互關聯。
傳回值
類型：HRESULT 此 API 作業的 HRESULT 傳回碼。備註
此函式會設定遊戲工作階段的自訂屬性值 (以 JSON 字串表示)。自訂屬性可以隨時變更。如果自訂屬性在裝置之間共用，或可能同時由多個裝置更新，請使用此函式來確保不可部分完成性，並在變更這些自訂屬性的值時解決裝置之間的衝突。如果自訂屬性未在裝置之間共用，請改用 XblMultiplayerManagerGameSessionSetProperties 函式來變更該自訂屬性的值。如果因衝突而發生競爭情形，服務可能會拒絕變更自訂屬性的要求。如果要求遭到拒絕，服務會傳回
HTTP_E_STATUS_PRECOND_FAILED。如果發生衝突，請重新評估是否需要變更自訂屬性，並視需要再次呼叫此函式以重新提交要求。此函式的結果會以多人遊戲事件的形式傳遞，其事件類型設定為
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted。您可以呼叫 XblMultiplayerManagerDoWork 來擷取多人遊戲事件。
需求
標頭： multiplayer_manager_c.h 程式庫： Microsoft.Xbox.Services.14x.GDK.C.lib另請參閱
multiplayer_manager_cXblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent