GameSaveContainer.SubmitUpdatesAsync Méthode
Définition
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.
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
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.
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
Type : IAsyncOperation< ; GameSaveOperationResult> ;
IAsyncOperation< ; GameSaveOperationResult> ; qui représente l’état de l’opération asynchrone.
- Attributs
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.