> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSaveCreateContainer

> XGameSaveCreateContainer

# XGameSaveCreateContainer

建立 XGameSaveContainer 控制代碼。

## 語法

```cpp theme={null}
HRESULT XGameSaveCreateContainer(  
         XGameSaveProviderHandle provider,  
         const char* containerName,  
         XGameSaveContainerHandle* containerContext  
)  
```

### 參數

*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)。

## 備註

<Note>在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

<Note>XGameSave API 需要正確設定遊戲的遊戲識別碼 (title ID) 和服務設定識別碼 (SCID)</Note>
才能運作。如需這些必要識別碼的詳細資訊，請參閱[設定 XBOX
Live 開發的沙箱](/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)。您的遊戲必須在 Partner Center 中啟用 XBOX Live。

如果您未正確設定 SCID 和遊戲識別碼，XSaveGame API 呼叫將會失敗並傳回下列錯誤碼：

E\_GS\_NO\_ACCESS - 0x80830002 - 作業失敗，因為遊戲沒有容器儲存空間的存取權。

XGameSaveCreateContainer 可用來建立新容器，也可以使用名稱作為識別碼
來存取先前建立的容器。遊戲存檔容器會以 [XGameSaveBlobs](/zh-TW/reference/system/xgamesave/structs/xgamesaveblob) 的形式保存玩家的相關資訊。
Blob 是與玩家相關聯的特定資料，該資料包括名稱和值，以及其他有助於
讀取 Blob 資料的資訊。您可以在
[XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo) 結構中找到 **XGameSaveContainer** 的組成。

<Note>在針對容器呼叫 [XGameSaveSubmitUpdate](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdate) 或 [XGameSaveSubmitUpdateAsync](/zh-TW/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) 之前，容器不會完成。在呼叫更新 API 之前，容器不會出現在 [XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) 的結果中。</Note>

## 需求

**標頭：** XGameSave.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[XGameSaveBlob](/zh-TW/reference/system/xgamesave/structs/xgamesaveblob)\
[遊戲存檔偵錯](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveCloseContainer](/zh-TW/reference/system/xgamesave/functions/xgamesaveclosecontainer.md)
- [XGameSaveGetContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [XGameSave API 概觀](/zh-TW/build/core-features/common/game-save/xgamesave.md)
- [XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members.md)
- [適用於 GDK 的 Unity C# API 包裝函式](/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)