ConnectedStorageContainer Class

Encapsulates connected storage.

Syntax

public ref class ConnectedStorageContainer sealed

Remarks

Note The Connected Storage API requires your title to have its title ID and service configuration ID (SCID) properly configured in order to work. For more information about these required IDs, see Setting Up Sandboxes for Xbox Live Development.

If you do not set your SCID and Title ID in the Package.appxmanifest properly, your Connected Storage API calls will fail with the following error code:

NoAccess - 0x80830002 - The operation failed because the title does not have write access to the container storage space.

If you do not have the ConnectedStorage service enabled for your SCID or you do not configure and publish your Xbox Live config properly, the Connected Storage API may present UI saying that it was unable to get your latest save data. See Xbox Live Services for more documentation.

Important Data dependencies across connected storage containers are unsafe. For example, an upload of one container to the cloud might complete, while another one might remain queued for upload. If the user moved to another console, the sync operation would allow the first container to be synchronized and accessed on the second console, without the first container being present.

Important A signed-in user is required to perform operations on per-user connected storage containers.

You should not cache a per-user ConnectedStorageContainer after a user has signed-out - operations performed on it will fail with error code E_FAIL (0x80004005).

If you need to save data for a user as the user is signing-out, you will need to complete your SubmitUpdatesAsync operation within the User::SignOutStarted event callback, or take a deferral from within the User::SignOutStarted callback - see the documentation for SignOutDeferral for more information.

Requirements

Namespace: Windows.Xbox.Storage

Metadata: windows.winmd

ConnectedStorageContainer Class

Syntax

Remarks

Requirements

See also

Reference