> ## 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.

# XGameSaveContainerInfo

> XGameSaveContainerInfo

# XGameSaveContainerInfo

XGameSaveContainer 的相關資訊。

## 語法

```cpp theme={null}
typedef struct XGameSaveContainerInfo {  
    const char* name;  
    const char* displayName;  
    uint32_t blobCount;  
    uint64_t totalSize;  
    time_t lastModifiedTime;  
    bool needsSync;  
} XGameSaveContainerInfo  
```

### 成員

*name*\
類型：const char\*

XGameSaveContainer 的名稱。

*displayName*\
類型：const char\*

XGameSaveContainer 的顯示名稱。

*blobCount*\
類型：uint32\_t

XGameSaveContainer 中的 Blob 數目。

*totalSize*\
類型：uint64\_t

XGameSaveContainer 的總大小。

*lastModifiedTime*\
類型：time\_t

上次更新 XGameSaveContainer 的時間。

*needsSync*\
類型：bool

布林值，指定本機與伺服器端的遊戲存檔資料之間是否有差異。

<Note>只有在您呼叫 XGameSaveInitializeProviderAsync 並將 syncOnDemand 設為 true 時，此值才會是 true。嘗試對 needsSync 為 true 的容器讀取或寫入資料，可能會導致同步 UX 顯示在遊戲上方。</Note>

## 備註

此結構描述 **XGameSaveContainer**，也可以簡稱為容器。容器保存一或多份從遊戲儲存、具有某種共同主題或用途的資料。它相當於檔案儲存系統中的資料夾。容器中會填入 [XGameSaveBlob](/zh-TW/reference/system/xgamesave/structs/xgamesaveblob) 物件，其中包含個別的資料片段。GameSave API 在容器層級提供不可部分完成的更新，因此套用的任何作業都會完全成功或完全不執行。如果您嘗試變更容器內的多個 Blob，而其中一個 Blob 更新失敗，則在作業結束時，容器中的每個 Blob 都將保持不變。您可以使用 [XGameSaveEnumerateContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) 或 [XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) 函式來尋找遊戲的容器。**XGameSaveContainerInfo** 是 [XGameSaveContainerInfoCallback](/zh-TW/reference/system/xgamesave/functions/xgamesavecontainerinfocallback) 的參數。

## 需求

**標頭：** XGameSave.h

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

## 另請參閱

[XGameSave](/zh-TW/reference/system/xgamesave/xgamesave_members)\
[XGameSaveEnumerateContainerInfo](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname)\
[XGameSaveContainerInfoCallback](/zh-TW/reference/system/xgamesave/functions/xgamesavecontainerinfocallback)


## Related topics

- [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
- [XGameSaveContainerInfoCallback](/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md)