GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает частично синхронизированный поставщик сохранения игры, который синхронизирует контейнеры по запросу.
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)Параметры
- serviceConfigId
-
String
Platform::String
winrt::hstring
Тип: String [JavaScript] | System.String [.NET] | Platform::String [C++]
Идентификатор конфигурации службы (SCID), используемый игрой.
Возвращаемое значение
Тип: IAsyncOperation<; GameSaveProviderGetResult>;
IAsyncOperation<; GameSaveProviderGetResult>; представляет состояние асинхронной операции.
- Атрибуты
Комментарии
Поставщик синхронизации по запросу не гарантирует локальную синхронизацию всех контейнеров. Синхронизация требуется при возникновении конфликта, который пользователь должен разрешить, или, чаще всего, когда в контейнере есть новые данные в облаке, которые необходимо скачать. На это условие указывает GameSaveContainerInfo.NeedsSync.
Вызовы для чтения, удаления или запроса больших двоичных объектов из контейнера будут синхронизировать контейнер, если ему требуется синхронизация.
Попытка отправить обновления в контейнер завершится ошибкой (с GameSaveErrorStatus.ContainerNotInSync), пока контейнер по-прежнему должен синхронизироваться.
GetSyncOnDemandForUserAsync получает экземпляр GameSaveProvider для указанного пользователя. После завершения асинхронной операции проверка свойство Status результата, чтобы определить, успешно ли выполнена операция с помощью GameSaveErrorStatus.Ok.
Ваш идентификатор заголовка и идентификатор конфигурации службы (SCID) должны быть правильно настроены, иначе этот метод завершится ошибкой.