Skip to main content

​
XGameSaveCreateContainer

建立 XGameSaveContainer 控制代碼。

​
語法

​
參數

provider   _In_
類型：XGameSaveProviderHandle 將建立容器之 XGameSaveProvider 的控制代碼。 containerName   _In_z_
類型：char* 要建立之容器的名稱。 容器名稱中路徑部分 (到最後一個正斜線為止，包含該正斜線) 的有效字元包括 大寫字母 (A-Z)、小寫字母 (a-z)、數字 (0-9)、底線 (_) 和正斜線 (/)。路徑 部分可以是空的。 檔案名稱部分 (最後一個正斜線之後的所有內容) 的有效字元包括大寫字母 (A-Z)、 小寫字母 (a-z)、數字 (0-9)、底線 (_)、句點 (.) 和連字號 (-)。檔案名稱不可為空、 不可以句點結尾，也不可包含兩個連續的句點。 容器名稱的最大長度為 256 個字元。 containerContext   _Outptr_result_nullonfailure_
類型：XGameSaveContainerHandle* 此函式呼叫所要傳回之 XGameSaveContainer 的控制代碼。

​
傳回值

類型：HRESULT 函式結果。如果 containerName 無效，函式將傳回 E_GS_INVALID_CONTAINER_NAME (0x80830001)。

​
備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。
XGameSave API 需要正確設定遊戲的遊戲識別碼 (title ID) 和服務設定識別碼 (SCID)
才能運作。如需這些必要識別碼的詳細資訊，請參閱設定 XBOX Live 開發的沙箱。您的遊戲必須在 Partner Center 中啟用 XBOX Live。 如果您未正確設定 SCID 和遊戲識別碼，XSaveGame API 呼叫將會失敗並傳回下列錯誤碼： E_GS_NO_ACCESS - 0x80830002 - 作業失敗，因為遊戲沒有容器儲存空間的存取權。 XGameSaveCreateContainer 可用來建立新容器，也可以使用名稱作為識別碼 來存取先前建立的容器。遊戲存檔容器會以 XGameSaveBlobs 的形式保存玩家的相關資訊。 Blob 是與玩家相關聯的特定資料，該資料包括名稱和值，以及其他有助於 讀取 Blob 資料的資訊。您可以在 XGameSaveContainerInfo 結構中找到 XGameSaveContainer 的組成。
在針對容器呼叫 XGameSaveSubmitUpdate 或 XGameSaveSubmitUpdateAsync 之前，容器不會完成。在呼叫更新 API 之前，容器不會出現在 XGameSaveEnumerateContainerInfoByName 的結果中。

​
需求

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

​
概念文件

​
另請參閱

XGameSave
XGameSaveContainerInfo
XGameSaveBlob
遊戲存檔偵錯
Last modified on October 6, 2026