Skip to main content

Microsoft.Xbox.Wrappers.XGameSave.Provider.Initialize

Initializes the save game wrapper, and synchronizes all of the containers for the specified user.

Syntax

Parameters

userHandle _In_
Type: XUserHandle
A handle to the XBOX Live User account. serviceConfigurationId _In_
Type: std::string
The game’s Service Configuration ID (SCID).

Return value

Type: HRESULT This method returns S_OK upon success, and the following HRESULT codes upon failure:
  • E_GS_USER_CANCELED
  • E_GS_USER_NOT_REGISTERED_IN_SERVICE
  • E_GS_NO_ACCESS
  • E_GS_NO_SERVICE_CONFIGURATION

Remarks

You must call this method before you can call any other method from the Provider class. You shouldn’t call this method on the game’s UI thread because it can block, and then potentially show UI to the user as it synchronizes their game saves. To load the data from the given blob, from the specified container, call Load.

Requirements

Header: xgamesavewrappers.hpp Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave wrapper members
Last modified on August 20, 2026