Se você precisar gerenciar dados
XGameSave no PC, deverá usar a
ferramenta de linha de comando xgamesaveutil.exe.xbstorage reset
Apaga todos os dados locais do armazenamento XGameSave no console local, restaurando-o às configurações de fábrica. Os dados mantidos na nuvem não são modificados e são baixados novamente, se necessário.xbstorage import
Importa os dados especificados em filename para um espaço de armazenamento XGameSave. Esse arquivo XML contém os dados. Para ver um exemplo, veja xbstorage generate neste tópico. Para obter mais informações sobre o formato XML do arquivo, veja Formato do arquivo de importação e exportação neste tópico. Há duas formas de especificar um espaço de armazenamentoXGameSave.
-
Se o arquivo de entrada tiver uma seção ContextDescription preenchida corretamente, essas informações serão usadas para especificar o espaço de armazenamento
XGameSave. - Você também pode especificar parcial ou totalmente o espaço de armazenamento usando parâmetros de linha de comando. Esses parâmetros têm precedência sobre os elementos correspondentes no arquivo de entrada.
XGameSave especificado com a nuvem usando a mesma lógica executada quando um aplicativo em execução adquire um espaço de armazenamento XGameSave.
Depois que a importação é concluída, o console começa a carregar os dados importados para a nuvem em segundo plano. O upload é concluído antes que o bloqueio da nuvem seja liberado. Esse comportamento difere da ferramenta de PC (xgamesaveutil), que grava dados somente no armazenamento local e não dispara um upload para a nuvem. Para obter mais informações, veja Gerenciar dados XGameSave no PC (xgamesaveutil.exe).
Se um aplicativo com o mesmo identificador de configuração de serviço (SCID) primário estiver em execução, essa operação poderá causar uma condição de corrida e deixar o conteúdo do espaço de armazenamento XGameSave em um estado indeterminado.
Se /replace não for especificado, os contêineres especificados no arquivo de entrada serão apagados antes que os blobs especificados no arquivo de entrada sejam gravados. Os contêineres do espaço de armazenamento XGameSave que não estiverem especificados no arquivo de entrada não serão alterados.
xbstorage export
Exporta dados de um espaço de armazenamentoXGameSave para o arquivo especificado por outfile. O arquivo XML contém os dados exportados. Para ver um exemplo, veja xbstorage generate neste artigo. Para obter mais informações sobre o formato XML, veja Formato do arquivo de importação e exportação.
Há duas formas de especificar o espaço de armazenamento XGameSave.
-
Se o parâmetro /context for usado e o nome de arquivo especificado por <infile> tiver uma seção ContextDescription preenchida corretamente, esse arquivo será usado para especificar o espaço de armazenamento
XGameSave. - Você também pode especificar parcial ou totalmente o espaço de armazenamento usando parâmetros de linha de comando. Esses parâmetros têm precedência sobre os elementos correspondentes especificados por /context.
XGameSave especificado com a nuvem usando a mesma lógica executada quando um aplicativo em execução adquire um espaço de armazenamento XGameSave.
Se um aplicativo com o mesmo SCID primário estiver em execução, essa operação poderá causar uma condição de corrida e deixar o conteúdo do espaço de armazenamento XGameSave em um estado indeterminado.
xbstorage delete
Exclui todos os dados de um espaço de armazenamentoXGameSave. Há duas formas de especificar o espaço de armazenamento XGameSave.
-
Se você usar o parâmetro /context e o arquivo especificado por <input-file> tiver uma seção ContextDescription preenchida corretamente, esse arquivo será usado para especificar o espaço de armazenamento
XGameSave. - Você também pode especificar parcial ou totalmente o espaço de armazenamento usando parâmetros de linha de comando. Esses parâmetros têm precedência sobre os elementos correspondentes especificados por /context.
XGameSave especificado com a nuvem usando a mesma lógica executada quando um aplicativo em execução adquire um espaço de armazenamento XGameSave.
Se um aplicativo com o mesmo SCID primário estiver em execução, essa operação poderá causar uma condição de corrida e deixar o conteúdo do espaço de armazenamento XGameSave em um estado indeterminado.
xbstorage generate
Gera dados fictícios e os salva no arquivo especificado por <file-name>. Para obter mais informações sobre o formato XML, veja Formato do arquivo de importação e exportação. O SCID é definido como 00000000-0000-0000-0000-000000000000, e a conta é definida para um espaço de armazenamentoXGameSave por máquina. Para alterar esses valores, edite o arquivo diretamente após a geração.
Use os exemplos a seguir.
XGameSave por usuário, altere o nó Account no arquivo XML conforme mostrado no exemplo a seguir.
xbstorage simulate
Simula condições de falta de armazenamento local para o serviço de armazenamentoXGameSave.
Opções comuns
Formato do arquivo de importação e exportação
O arquivo XML usado com os comandos import, export e generate tem o formato mostrado no exemplo a seguir.XGameSave para um usuário, poderá usar <Account msa="user@example.com"/> em vez de <Account machine="true"/>. Caso contrário, você pode especificar o contexto na linha de comando para a importação.
Os blobs e contêineres devem ter os nomes correspondentes atribuídos a eles pelo jogo ou aplicativo para o qual o arquivo está sendo gerado.
O conteúdo de cada blob deve ser uma string encapsulada em uma marca CDATA, gerada chamando CryptBinaryToStringW com o sinalizador CRYPT_STRING_BASE64 e fornecendo os dados desse blob como uma matriz de bytes brutos. Por outro lado, os dados do blob podem ser convertidos de volta chamando CryptStringToBinary para fornecer a string anteriormente criptografada. Para ver um exemplo de uso dessas duas funções, veja CryptBinaryToString returns invalid bytes.