GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) 方法

定义

命名空间:

Windows.Gaming.XboxLive.Storage

获取按需同步容器的部分同步游戏保存提供程序。

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)

参数

user

User

类型： 用户

保存游戏的用户。

serviceConfigId

String

Platform::String

winrt::hstring

类型： 字符串 [JavaScript] | System.String [.NET] | Platform：：String [C++]

游戏使用的服务配置 ID (SCID) 。

返回

IAsyncOperation<GameSaveProviderGetResult>

类型： IAsyncOperation<;GameSaveProviderGetResult>;

IAsyncOperation<;GameSaveProviderGetResult>; 表示异步操作的状态。

属性

RemoteAsyncAttribute

注解

不保证同步按需提供程序在本地同步所有容器。 如果存在用户必须解决的冲突，或者更常见的是，当容器在云中具有必须下载的较新数据时，需要同步。 此条件由 GameSaveContainerInfo.NeedsSync 指示。

如果需要同步，从容器中读取、删除或查询 Blob 的调用将同步容器。

尝试向容器提交更新将失败， (GameSaveErrorStatus.ContainerNotInSync) 容器仍然需要同步。

GetSyncOnDemandForUserAsync 获取指定用户的 GameSaveProvider 实例。 异步操作完成后，检查结果的 Status 属性，以确定操作是否在 GameSaveErrorStatus.Ok 中成功。

必须正确配置游戏 ID 和服务配置 ID (SCID) ，否则此方法将失败。

另请参阅

• GameSaveProvider