Skip to main content

Microsoft.Xbox.Wrappers.XGameSave.Provider.Save

將資料儲存到指定容器內的指定 Blob (檔案)。

語法

參數

containerName _In_
類型:std::string
容器的名稱。 blobName _In_
類型:std::string
Blob 的名稱。 dataSize _In_
類型:size_t
要寫入 Blob 的資料量。此大小上限為 16 MB (GS_MAX_BLOB_SIZE)。 blobData _In_
類型:uint8_t*
指向要寫入 Blob 之位元組的指標。

傳回值

類型:HRESULT 此方法成功時會傳回 S_OK,失敗時則會傳回下列 HRESULT 代碼:
  • GS_INVALID_CONTAINER_NAME
  • GS_OUT_OF_LOCAL_STORAGE
  • GS_UPDATE_TOO_BIG
  • GS_QUOTA_EXCEEDED
  • GS_HANDLE_EXPIRED

範例

下列程式碼範例示範如何使用 Save 函式。

備註

您必須先呼叫 Initialize 方法,才能呼叫 Provider 類別中的任何其他方法。 若要初始化遊戲存檔包裝函式,並同步處理指定使用者的所有容器,請呼叫 Initialize。 若要從指定容器中的指定 Blob 載入資料,請呼叫 Load。

需求

標頭: xgamesavewrappers.hpp 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 包裝函式成員
Load
Last modified on October 6, 2026