Si vous devez gérer des données
XGameSave sur PC, vous devez utiliser
l’outil en ligne de commande xgamesaveutil.exe.xbstorage reset
Efface toutes les données locales du stockage XGameSave de la console locale et rétablit celui-ci aux paramètres d’usine. Les données conservées dans le cloud ne sont pas modifiées et sont à nouveau téléchargées si nécessaire.xbstorage import
Importe les données spécifiées dans filename dans un espace de stockage XGameSave. Ce fichier XML contient les données. Pour un exemple, consultez xbstorage generate dans cette rubrique. Pour plus d’informations sur le format XML du fichier, consultez Format des fichiers d’importation et d’exportation dans cette rubrique. Il existe deux façons de spécifier un espace de stockageXGameSave.
-
Si le fichier d’entrée comporte une section ContextDescription correctement renseignée, ces informations sont utilisées pour spécifier l’espace de stockage
XGameSave. - Vous pouvez également spécifier partiellement ou entièrement l’espace de stockage à l’aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants du fichier d’entrée.
XGameSave spécifié avec le cloud, à l’aide de la même logique que celle exécutée lorsqu’une application en cours d’exécution acquiert un espace de stockage XGameSave.
Une fois l’importation terminée, la console commence à charger les données importées vers le cloud en arrière-plan. Le chargement se termine avant la libération du verrou cloud. Ce comportement diffère de celui de l’outil PC (xgamesaveutil), qui écrit les données uniquement dans le stockage local et ne déclenche pas de chargement vers le cloud. Pour plus d’informations, consultez Gérer les données XGameSave sur PC (xgamesaveutil.exe).
Si une application ayant le même identificateur de configuration de service (SCID) principal est en cours d’exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l’espace de stockage XGameSave dans un état indéterminé.
Si /replace n’est pas spécifiée, les conteneurs spécifiés dans le fichier d’entrée sont effacés avant l’écriture des objets blob spécifiés dans le fichier d’entrée. Les conteneurs de l’espace de stockage XGameSave qui ne sont pas spécifiés dans le fichier d’entrée ne sont pas modifiés.
xbstorage export
Exporte les données d’un espace de stockageXGameSave vers le fichier spécifié par outfile. Le fichier XML contient les données exportées. Pour un exemple, consultez xbstorage generate dans cet article. Pour plus d’informations sur le format XML, consultez Format des fichiers d’importation et d’exportation.
Il existe deux façons de spécifier l’espace de stockage XGameSave.
-
Si le paramètre /context est utilisé et que le fichier spécifié par <infile> comporte une section ContextDescription correctement renseignée, ce fichier est utilisé pour spécifier l’espace de stockage
XGameSave. - Vous pouvez également spécifier partiellement ou entièrement l’espace de stockage à l’aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants spécifiés par /context.
XGameSave spécifié avec le cloud, à l’aide de la même logique que celle exécutée lorsqu’une application en cours d’exécution acquiert un espace de stockage XGameSave.
Si une application ayant le même SCID principal est en cours d’exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l’espace de stockage XGameSave dans un état indéterminé.
xbstorage delete
Supprime toutes les données d’un espace de stockageXGameSave. Il existe deux façons de spécifier l’espace de stockage XGameSave.
-
Si vous utilisez le paramètre /context et que le fichier spécifié par <input-file> comporte une section ContextDescription correctement renseignée, ce fichier est utilisé pour spécifier l’espace de stockage
XGameSave. - Vous pouvez également spécifier partiellement ou entièrement l’espace de stockage à l’aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants spécifiés par /context.
XGameSave spécifié avec le cloud, à l’aide de la même logique que celle exécutée lorsqu’une application en cours d’exécution acquiert un espace de stockage XGameSave.
Si une application ayant le même SCID principal est en cours d’exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l’espace de stockage XGameSave dans un état indéterminé.
xbstorage generate
Génère des données factices et les enregistre dans le fichier spécifié par <file-name>. Pour plus d’informations sur le format XML, consultez Format des fichiers d’importation et d’exportation. Le SCID est défini sur 00000000-0000-0000-0000-000000000000 et le compte est défini pour un espace de stockageXGameSave par machine. Pour modifier ces valeurs, modifiez directement le fichier après sa génération.
Utilisez les exemples suivants.
XGameSave par utilisateur, modifiez le nœud Account du fichier XML comme indiqué dans l’exemple suivant.
xbstorage simulate
Simule des conditions de manque d’espace de stockage local pour le service de stockageXGameSave.
Options courantes
Format des fichiers d’importation et d’exportation
Le fichier XML utilisé avec les commandes import, export et generate a le format illustré dans l’exemple suivant.XGameSave pour un utilisateur, vous pouvez utiliser <Account msa="user@example.com"/> au lieu de <Account machine="true"/>. Sinon, vous pouvez spécifier le contexte sur la ligne de commande lors de l’importation.
Les objets blob et les conteneurs doivent porter les noms correspondants que leur a attribués le jeu ou l’application pour lequel le fichier est généré.
Le contenu de chaque objet blob doit être une chaîne encapsulée dans une balise CDATA, générée en appelant CryptBinaryToStringW avec l’indicateur CRYPT_STRING_BASE64 et en fournissant les données de cet objet blob sous forme de tableau d’octets bruts. À l’inverse, les données d’un objet blob peuvent être reconverties en appelant CryptStringToBinary avec la chaîne précédemment chiffrée. Pour un exemple d’utilisation de ces deux fonctions, consultez CryptBinaryToString returns invalid bytes.