Skip to main content

XGameSaveGetContainerInfo

检索 XGameSaveProvider 中容器的信息。

Syntax

Parameters

provider   _In_
类型:XGameSaveProviderHandle
具有所需容器的 XGameSaveProvider 句柄。 containerName   _In_z_
类型:char*
要检索其信息的容器的名称,如果找到,将只返回一个结果。如果需要多个容器,请使用 XGameSaveEnumerateContainerInfoXGameSaveEnumerateContainerInfoByName context   _In_opt_
类型:void*
指向调用对象的指针,用于提供上下文。 callback   _In_
类型:XGameSaveContainerInfoCallback*
用于确定 XGameSaveContainerInfo 调用的结果并从中收集数据的回调函数。

Return value

类型:HRESULT 函数结果

常见错误

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Remarks

此函数在时间敏感型线程上调用是不安全的。有关详细信息,请参阅时间敏感型线程
容器是元数据的集合以及其中一组 Blob 的引用点。如果提前知道容器名称,则可以使用此 API 仅返回该容器的信息。这对于返回有关玩家的特定信息很有用,而不是每次需要信息时都要求提供所有信息。你可以在 XGameSaveContainerInfo 结构中找到 XGameSaveContainer 的组成。

Requirements

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

Conceptual documentation

See also

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