Skip to main content

XGameSaveSubmitUpdate

將更新提交至 XGameSave 服務。更新容器內的 Blob。

語法

參數

updateContext   _In_
類型:XGameSaveUpdateHandle
要更新之 XGameSaveUpdate 的控制代碼。

傳回值

類型:HRESULT 函式結果。 常見錯誤
  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_OUT_OF_LOCAL_STORAGE
  • E_GS_UPDATE_TOO_BIG
  • E_GS_QUOTA_EXCEEDED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
您必須先成功呼叫 XGameSaveCreateUpdate,才能進行此呼叫。 此 API 的儲存部分旨在以安全、可靠且交易式的方式,輕鬆地將資料從遊戲傳輸到永續性儲存體。我們希望確保容器的支援資料一律保持一致,因此希望整個作業以不可部分完成的方式成功或失敗。我們不希望發生部分更新,導致某些 Blob 資料與容器內的其他資料不一致。為了達成此目的,我們提供一個更新內容,Blob 的寫入和刪除會提交至此內容,待其準備就緒時再提交整個內容。實際上看起來如下: XGameSaveUpdate 會透過 XGameSaveSubmitBlobWrite 和 XGameSaveSubmitBlobDelete,填入要對容器內 Blob 執行的寫入和刪除動作。呼叫 XGameSaveSubmitUpdate 即可完成更新。 當您使用完 XGameSaveUpdate 時,請使用 XGameSaveCloseUpdate 方法將其關閉。 下列 C++ 範例示範同步 XGameSave 更新。

需求

標頭: XGameSave.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
XGameSaveCloseUpdate 偵錯遊戲存檔
Last modified on October 6, 2026