Skip to main content

XGameSaveEnumerateContainerInfoByName

检索 XGameSaveProvider 的容器信息。提供前缀将导致该函数仅返回具有相同前缀的名称。

Syntax

Parameters

provider   _In_
类型:XGameSaveProviderHandle
包含 XGameSaveContainerInfoXGameSaveProvider containerNamePrefix   _In_opt_z_
类型:char*
将用于在容器列表中搜索匹配容器名称的前缀。 context   _In_opt_
类型:void*
将传递给回调函数的指针。 callback   _In_
类型:XGameSaveContainerInfoCallback*
要为每个与前缀匹配的容器运行的回调函数,返回 false 以停止枚举。使用此函数收集 XGameSaveContainerInfo

Return value

类型:HRESULT 函数结果。

Remarks

使用此函数检查有哪些容器可用于某个用户。这可能包括需要在 UX 中显示的数据。枚举此集不会导致 SyncOnDemand 提供程序进行同步,并将允许调用方通过 XGameSaveContainerInfo 的 needsSync 字段实际检查同步状态。对 needsSync 设置为 true 的容器执行的任何 Blob 数据读取或对更新上下文的使用将强制同步,并可能返回各种同步错误。如果不需要为要枚举的容器指定前缀,则可以使用 XGameSaveEnumerateContainerInfoXGameSaveEnumerateContainerInfo 将返回所有可用容器的完整列表。

Requirements

头文件: XGameSave.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XGameSave
XGameSaveEnumerateContainerInfo
调试游戏保存
最后修改于 2026年8月24日