Compartilhar via


GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) Método

Definição

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

user
User

Tipo: Usuário

Usuário para quem o jogo salva.

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á.

Aplica-se a

Confira também