GameSaveContainer.SubmitUpdatesAsync 메서드

정의

네임스페이스:

Windows.Gaming.XboxLive.Storage

이 컨테이너의 게임 저장 Blob에 대한 변경 내용 집합을 제출합니다. 변경 내용은 Blob에 쓰거나 기존 Blob을 삭제할 수 있습니다. 컨테이너가 없으면 새 컨테이너가 만들어집니다. 모든 쓰기 및 업데이트는 원자 방식으로 적용됩니다. 동일한 Blob을 작성하고 삭제하려고 시도하면 오류가 발생합니다. 호출당 16MB의 데이터만 작성할 수 있습니다.

public:
 virtual IAsyncOperation<GameSaveOperationResult ^> ^ SubmitUpdatesAsync(IMapView<Platform::String ^, IBuffer ^> ^ blobsToWrite, IIterable<Platform::String ^> ^ blobsToDelete, Platform::String ^ displayName) = SubmitUpdatesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<GameSaveOperationResult> SubmitUpdatesAsync(IMapView<winrt::hstring, IBuffer const&> const& blobsToWrite, IIterable<winrt::hstring> const& blobsToDelete, winrt::hstring const& displayName);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<GameSaveOperationResult> SubmitUpdatesAsync(IReadOnlyDictionary<string,IBuffer> blobsToWrite, IEnumerable<string> blobsToDelete, string displayName);

function submitUpdatesAsync(blobsToWrite, blobsToDelete, displayName)

Public Function SubmitUpdatesAsync (blobsToWrite As IReadOnlyDictionary(Of String, IBuffer), blobsToDelete As IEnumerable(Of String), displayName As String) As IAsyncOperation(Of GameSaveOperationResult)

매개 변수

blobsToWrite

IMapView<String,IBuffer>

IReadOnlyDictionary<String,IBuffer>

IMapView<Platform::String,IBuffer>

IMapView<winrt::hstring,IBuffer>

형식: IMapView<; String, IBuffer>; [JavaScript/C++] | System.Collections.Generic.IReadOnlyDictionary<; String, IBuffer>; [.NET]

각 Blob에 대해 쓸 Blob 이름 및 데이터의 컬렉션입니다. Blob 이름의 최대 길이는 63자입니다.

blobsToDelete

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

형식: IIterable<; String>; [JavaScript/C++] | System.Collections.Generic.IEnumerable<; String>; [.NET]

삭제할 Blob의 문자열 이름을 포함하는 컬렉션입니다. Blob 이름의 최대 길이는 63자입니다.

displayName

String

Platform::String

winrt::hstring

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

게임 컨테이너의 표시 이름을 저장합니다. 게임 저장에 대해 표시할 이름으로 설정합니다. 표시 이름의 최대 길이는 127자입니다.

반환

IAsyncOperation<GameSaveOperationResult>

형식: IAsyncOperation<; GameSaveOperationResult>;

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

특성

RemoteAsyncAttribute

설명

비동기 작업이 완료된 후 결과의 Status 속성을 검사 작업이 GameSaveErrorStatus.Ok에 성공했는지 여부를 확인합니다.

각 TitleID/SCID는 사용자당 총 256MB의 스토리지로 제한됩니다.

타이틀이 사용자의 스토리지 한도에 도달하면 SubmitUpdatesAsync 에 대한 호출이 실패합니다.

Blob 이름 또는 표시 이름이 최대 길이를 초과하면 게임 저장이 업로드되지 않습니다.

SubmitUpdatesAsync 호출은 컨테이너를 유효한 상태로 두기 위해 향후 SubmitUpdatesAsync 호출이 성공적으로 완료될 것이라고 가정해서는 안 됩니다. 각 SubmitUpdatesAsync 호출은 지정된 컨테이너의 내용을 앱이 나중에 읽을 수 있도록 유효한 상태로 유지해야 합니다. 예를 들어 플레이어가 게임에서 금이 있는 음식을 구매하는 경우 SubmitUpdatesAsync에 대한 동일한 호출에서 금과 식품에 대한 새 값을 업데이트해야 합니다. 이렇게 하면 두 값이 동시에 업데이트되거나 전원 오류가 발생하거나 업데이트를 방해하는 다른 이벤트가 발생할 경우 음식 및 금 모두 원래 값이 유지됩니다.

추가 정보

• GameSaveContainer