GameSaveContainer.SubmitUpdatesAsync Méthode

Référence

Définition

Espace de noms:: Windows.Gaming.XboxLive.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Envoie un ensemble de modifications aux objets blob d’enregistrement de jeu dans ce conteneur. Les modifications peuvent être des écritures dans des objets blob ou la suppression d’objets blob existants. Si le conteneur n’existe pas, un nouveau conteneur est créé. Toutes les écritures et mises à jour sont appliquées de manière atomique. Toute tentative d’écriture et de suppression du même objet blob génère une erreur. Seuls 16 Mo de données peuvent être écrits par appel.

public:
 virtual IAsyncOperation<GameSaveOperationResult ^> ^ SubmitUpdatesAsync(IMapView<Platform::String ^, IBuffer ^> ^ blobsToWrite, IIterable<Platform::String ^> ^ blobsToDelete, Platform::String ^ displayName) = SubmitUpdatesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<GameSaveOperationResult> SubmitUpdatesAsync(IMapView<winrt::hstring, IBuffer const&> const& blobsToWrite, IIterable<winrt::hstring> const& blobsToDelete, winrt::hstring const& displayName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<GameSaveOperationResult> SubmitUpdatesAsync(IReadOnlyDictionary<string,IBuffer> blobsToWrite, IEnumerable<string> blobsToDelete, string displayName);

function submitUpdatesAsync(blobsToWrite, blobsToDelete, displayName)

Public Function SubmitUpdatesAsync (blobsToWrite As IReadOnlyDictionary(Of String, IBuffer), blobsToDelete As IEnumerable(Of String), displayName As String) As IAsyncOperation(Of GameSaveOperationResult)

Paramètres

blobsToWrite: IMapView<String,IBuffer>

IReadOnlyDictionary<String,IBuffer>

IMapView<Platform::String,IBuffer>

IMapView<winrt::hstring,IBuffer>

Type : IMapView<; String, IBuffer>; [JavaScript/C++] | System.Collections.Generic.IReadOnlyDictionary<; String, IBuffer>; [.NET]

Collection de noms d’objets blob et de données à écrire pour chaque objet blob. La longueur maximale d’un nom d’objet blob est de 63 caractères.

blobsToDelete: IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Type : IIterable< ; Chaîne>; [JavaScript/C++] | System.Collections.Generic.IEnumerable<; Chaîne>; [.NET]

Collection contenant les noms de chaîne des objets blob à supprimer. La longueur maximale d’un nom d’objet blob est de 63 caractères.

displayName: String
Platform::String

winrt::hstring

Type : String [JavaScript] | System.String [.NET] | Platform::String [C++]

Nom complet du conteneur de jeu d’enregistrement. Définissez cette valeur sur le nom qui sera affiché pour l’enregistrement du jeu. La longueur maximale du nom d’affichage est de 127 caractères.

Retours

IAsyncOperation<GameSaveOperationResult>

Type : IAsyncOperation< ; GameSaveOperationResult> ;

IAsyncOperation< ; GameSaveOperationResult> ; qui représente l’état de l’opération asynchrone.

Attributs: RemoteAsyncAttribute

Remarques

Une fois l’opération asynchrone terminée, case activée la propriété Status du résultat pour déterminer si l’opération a réussi avec GameSaveErrorStatus.Ok.

Chaque TitleID/SCID est limité à un total de 256 Mo de stockage par utilisateur.

Lorsqu’un titre a atteint sa limite de stockage pour un utilisateur, les appels à SubmitUpdatesAsync échouent.

Si un nom d’objet blob ou le nom d’affichage dépasse la longueur maximale, le chargement de l’enregistrement du jeu échoue.

Les appels SubmitUpdatesAsync ne doivent pas supposer qu’un prochain appel SubmitUpdatesAsync sera effectué correctement afin de laisser le conteneur dans un état valide. Chaque appel SubmitUpdatesAsync doit laisser le contenu du conteneur spécifié dans un état valide pour que l’application lise ultérieurement. Par exemple, si un joueur achète de la nourriture avec de l’or dans un jeu, les nouvelles valeurs pour l’or et la nourriture doivent être mises à jour dans le même appel à SubmitUpdatesAsync. Cela garantit que les deux valeurs seront mises à jour en même temps ou en cas de panne de courant ou d’un autre événement empêchant la mise à jour, la nourriture et l’or auront toujours leurs valeurs d’origine.

S’applique à

Voir aussi

GameSaveContainer

Partager via