GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) Methode

Definition

Namespace:

Windows.Gaming.XboxLive.Storage

Ruft einen teilweise synchronisierten Spielspeicheranbieter ab, der Container nach Bedarf synchronisiert.

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)

Parameter

user

User

Typ: Benutzer

Benutzer, für den das Spiel gespeichert wird.

serviceConfigId

String

Platform::String

winrt::hstring

Typ: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Die Dienstkonfigurations-ID (SCID), die von Ihrem Spiel verwendet wird.

Gibt zurück

IAsyncOperation<GameSaveProviderGetResult>

Typ: IAsyncOperation<; GameSaveProviderGetResult>;

IAsyncOperation<; GameSaveProviderGetResult>, das den Zustand des asynchronen Vorgangs darstellt.

Attribute

RemoteAsyncAttribute

Hinweise

Bei einem Synchronisierungs-on-Demand-Anbieter wird nicht garantiert, dass alle Container lokal synchronisiert werden. Eine Synchronisierung ist erforderlich, wenn ein Konflikt vorliegt, den der Benutzer lösen muss, oder häufiger, wenn der Container neuere Daten in der Cloud enthält, die heruntergeladen werden müssen. Diese Bedingung wird durch GameSaveContainerInfo.NeedsSync angegeben.

Aufrufe zum Lesen, Löschen oder Abfragen von Blobs aus einem Container synchronisieren den Container, wenn er synchronisiert werden muss.

Versuche, Updates an einen Container zu übermitteln, schlagen fehl (mit GameSaveErrorStatus.ContainerNotInSync), während der Container noch synchronisiert werden muss.

GetSyncOnDemandForUserAsync ruft einen GameSaveProvider-instance für den angegebenen Benutzer ab. Überprüfen Sie nach Abschluss des asynchronen Vorgangs die Status-Eigenschaft des Ergebnisses, um zu bestimmen, ob der Vorgang mit GameSaveErrorStatus.Ok erfolgreich war.

Ihre Titel-ID und Dienstkonfigurations-ID (SCID) müssen ordnungsgemäß konfiguriert sein, andernfalls tritt bei dieser Methode ein Fehler auf.

Weitere Informationen

• GameSaveProvider