> ## 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** 的容器信息。

## Syntax

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

### Parameters

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

包含 [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) 的 **XGameSaveProvider** 的句柄。

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

将传递给回调函数的指针。

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

要为每个容器运行的回调函数，返回 false 以停止枚举。使用此函数收集 XGameSaveContainerInfo。

### Return value

类型：HRESULT

函数结果

## Remarks

使用此函数检查有哪些容器可用于某个用户。这可能包括需要在 UX 中显示的数据。枚举此集不会导致 SyncOnDemand 提供程序进行同步，并将允许调用方通过 [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) 的 needsSync 字段实际检查同步状态。对 *needsSync* 设置为 true 的容器执行的任何 Blob 数据读取或对更新上下文的使用将强制同步，并可能返回各种同步错误。
你可以使用 [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) 通过指定必须匹配的前缀来筛选容器，然后再返回该容器的信息。

## Requirements

**头文件：** XGameSave.h

**库：** xgameruntime.lib

**受支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## Conceptual documentation

* [时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo)\
[调试游戏保存](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfoByName](/zh-CN/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md)
- [XGameSaveContainerInfo](/zh-CN/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
- [XGameSaveContainerInfoCallback](/zh-CN/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md)
- [XGameSaveGetContainerInfo](/zh-CN/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)