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

# XGameSaveEnumerateContainerInfo

> XGameSaveEnumerateContainerInfo

# XGameSaveEnumerateContainerInfo

擷取 **XGameSaveProvider** 的容器資訊。

## 語法

```cpp theme={null}
HRESULT XGameSaveEnumerateContainerInfo(  
         XGameSaveProviderHandle provider,  
         void* context,  
         XGameSaveContainerInfoCallback* callback  
)  
```

### 參數

*provider*   \_In\_\
類型：XGameSaveProviderHandle

包含 [XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo) 的 **XGameSaveProvider** 控制代碼。

*context*   \_In\_opt\_\
類型：void\*

將傳遞至回呼函式的指標。

*callback*   \_In\_\
類型：XGameSaveContainerInfoCallback\*

針對每個容器執行的回呼函式，傳回 false 可停止列舉。使用此函式收集 XGameSaveContainerInfo。

### 傳回值

類型：HRESULT

函式結果

## 備註

使用此函式檢查使用者有哪些可用的容器。這可能包括需要在 UX 中顯示的資料。列舉這組容器不會對 SyncOnDemand 提供者觸發同步，並可讓呼叫端透過 [XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo) 的 needsSync 欄位實際檢查同步狀態。對 *needsSync* 設為 true 的容器進行任何 Blob 資料讀取或使用更新內容，都會強制同步，並可能傳回各種同步錯誤。
您可以使用 [XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) 篩選容器，方法是指定一個前置詞，容器必須符合該前置詞才會傳回其資訊。

## 需求

**標頭：** 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)\
[XGameSaveEnumerateContainerInfoByName](/zh-TW/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[XGameSaveContainerInfo](/zh-TW/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md)
- [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md)