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