Microsoft.Xbox.Wrappers.XGameSave.Provider.Initialize

对保存游戏包装器进行初始化,并为该游戏的特定用户强制同步所有容器。

语法

HRESULT Initialize(XUserHandle userHandle,
                   const std::string& serviceConfigurationId);

参数

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 包装器成员
游戏存档简化包装器