Skip to main content

Microsoft.Xbox.Wrappers.XGameSave.Provider.Initialize

初始化保存游戏包装器,并同步指定用户的所有容器。

语法

参数

userHandle _In_
类型:XUserHandle
XBOX Live 用户账户的句柄。 serviceConfigurationId _In_
类型:std::string
游戏的服务配置 ID (SCID)。

返回值

类型:HRESULT 此方法在成功时返回 S_OK,在失败时返回以下 HRESULT 代码:
  • E_GS_USER_CANCELED
  • E_GS_USER_NOT_REGISTERED_IN_SERVICE
  • E_GS_NO_ACCESS
  • E_GS_NO_SERVICE_CONFIGURATION

备注

必须先调用此方法,然后才能调用 Provider 类中的任何其他方法。 不应在游戏的 UI 线程上调用此方法,因为它可能会阻塞,并且在同步用户的游戏存档时可能会向用户显示 UI。 若要从指定容器中加载给定 Blob 的数据,请调用 Load

要求

标头: xgamesavewrappers.hpp 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 包装器成员
最后修改于 2026年8月24日