GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um provedor de salvamento de jogo parcialmente sincronizado que sincroniza contêineres sob demanda.
public:
static IAsyncOperation<GameSaveProviderGetResult ^> ^ GetSyncOnDemandForUserAsync(User ^ user, Platform::String ^ serviceConfigId);
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<GameSaveProviderGetResult> GetSyncOnDemandForUserAsync(User const& user, winrt::hstring const& serviceConfigId);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<GameSaveProviderGetResult> GetSyncOnDemandForUserAsync(User user, string serviceConfigId);
function getSyncOnDemandForUserAsync(user, serviceConfigId)
Public Shared Function GetSyncOnDemandForUserAsync (user As User, serviceConfigId As String) As IAsyncOperation(Of GameSaveProviderGetResult)
Parâmetros
- serviceConfigId
-
String
Platform::String
winrt::hstring
Tipo: Cadeia de caracteres [JavaScript] | System.String [.NET] | Platform::String [C++]
A SCID (ID de configuração de serviço) usada pelo jogo.
Retornos
Tipo: IAsyncOperation<; GameSaveProviderGetResult>;
IAsyncOperation<; GameSaveProviderGetResult>; que representa o estado da operação assíncrona.
- Atributos
Comentários
Não há garantia de que um provedor de sincronização sob demanda tenha todos os contêineres sincronizados localmente. Uma sincronização é necessária quando há um conflito que o usuário deve resolve ou, mais comumente, quando o contêiner tem dados mais recentes na nuvem que devem ser baixados. Essa condição é indicada por GameSaveContainerInfo.NeedsSync.
Chamadas para ler, excluir ou consultar blobs de um contêiner sincronizarão o contêiner se ele precisar ser sincronizado.
As tentativas de enviar atualizações para um contêiner falharão (com GameSaveErrorStatus.ContainerNotInSync) enquanto o contêiner ainda precisa ser sincronizado.
GetSyncOnDemandForUserAsync obtém uma instância de GameSaveProvider para o usuário especificado. Após a conclusão da operação assíncrona, marcar a propriedade Status do resultado para determinar se a operação foi bem-sucedida com GameSaveErrorStatus.Ok.
A ID do título e a ID de configuração de serviço (SCID) devem ser configuradas corretamente ou esse método falhará.