XGameSaveEnumerateContainerInfoByName
检索 XGameSaveProvider 的容器信息。提供前缀将导致该函数仅返回具有相同前缀的名称。Syntax
Parameters
provider _In_类型:XGameSaveProviderHandle 包含 XGameSaveContainerInfo 的 XGameSaveProvider。 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 数据读取或对更新上下文的使用将强制同步,并可能返回各种同步错误。如果不需要为要枚举的容器指定前缀,则可以使用 XGameSaveEnumerateContainerInfo。XGameSaveEnumerateContainerInfo 将返回所有可用容器的完整列表。Requirements
头文件: XGameSave.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机Conceptual documentation
See also
XGameSaveXGameSaveEnumerateContainerInfo
调试游戏保存
