다음을 통해 공유


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)

매개 변수

user
User

형식: 사용자

게임 저장 대상 사용자입니다.

serviceConfigId
String

Platform::String

winrt::hstring

형식: 문자열 [JavaScript] | System.String [.NET] | Platform::String [C++]

게임에서 사용하는 SCID(서비스 구성 ID)입니다.

반환

형식: IAsyncOperation<; GameSaveProviderGetResult>;

IAsyncOperation<; GameSaveProviderGetResult>: 비동기 작업의 상태를 나타냅니다.

특성

설명

주문형 동기화 공급자가 모든 컨테이너를 로컬로 동기화하도록 보장되지는 않습니다. 동기화는 사용자가 resolve 해야 하는 충돌이 있는 경우 또는 더 일반적으로 컨테이너에 다운로드해야 하는 클라우드의 최신 데이터가 있는 경우에 필요합니다. 이 조건은 GameSaveContainerInfo.NeedsSync로 표시됩니다.

컨테이너에서 Blob을 읽거나 삭제하거나 쿼리하는 호출은 동기화해야 하는 경우 컨테이너를 동기화합니다.

컨테이너를 동기화해야 하는 동안 컨테이너에 업데이트를 제출하려고 하면 실패합니다( GameSaveErrorStatus.ContainerNotInSync 사용).

GetSyncOnDemandForUserAsync는 지정된 사용자에 대한 GameSaveProvider instance 가져옵니다. 비동기 작업이 완료되면 결과의 Status 속성을 검사 작업이 GameSaveErrorStatus.Ok에 성공했는지 여부를 확인합니다.

타이틀 ID 및 SCID(서비스 구성 ID)를 올바르게 구성해야 합니다. 그렇지 않으면 이 메서드가 실패합니다.

적용 대상

추가 정보