GameSaveContainer.ReadAsync(IMapView<String,IBuffer>) Method

Reference

Definition

Namespace:: Windows.Gaming.XboxLive.Storage

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Reads blobs from this container, as specified by blobsToRead. The buffers passed in blobsToRead must be large enough to store the blob data.

public:
 virtual IAsyncOperation<GameSaveOperationResult ^> ^ ReadAsync(IMapView<Platform::String ^, IBuffer ^> ^ blobsToWrite) = ReadAsync;

public:
 virtual IAsyncOperation<GameSaveOperationResult ^> ^ ReadAsync(IMapView<Platform::String ^, IBuffer ^> ^ blobsToRead) = ReadAsync;

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

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<GameSaveOperationResult> ReadAsync(IMapView<winrt::hstring, IBuffer const&> const& blobsToRead);

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

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<GameSaveOperationResult> ReadAsync(IReadOnlyDictionary<string,IBuffer> blobsToRead);

function readAsync(blobsToWrite)

function readAsync(blobsToRead)

Public Function ReadAsync (blobsToWrite As IReadOnlyDictionary(Of String, IBuffer)) As IAsyncOperation(Of GameSaveOperationResult)

Public Function ReadAsync (blobsToRead As IReadOnlyDictionary(Of String, IBuffer)) As IAsyncOperation(Of GameSaveOperationResult)

Parameters

blobsToWriteblobsToRead: IMapView<String,IBuffer>

IReadOnlyDictionary<String,IBuffer>

IMapView<Platform::String,IBuffer>

IMapView<winrt::hstring,IBuffer>

Returns

IAsyncOperation<GameSaveOperationResult>

Type: IAsyncOperation<;GameSaveOperationResult>;

IAsyncOperation<;GameSaveOperationResult>; that represents the state of the asynchronous operation.

Attributes: RemoteAsyncAttribute

Remarks

Use GameSaveBlobInfoQuery to determine the required buffer size for each game save blob requested.

If the operation completes successfully, the length property of the returned buffers specifies the amount of data contained in each buffer.

ReadAsync differs from GetAsync in that GetAsync automatically allocates the required buffers for the blob data, and returns that data in a GameSaveBlobGetResult object. ReadAsync instead writes directly into the buffers passed in the blobsToRead parameter.

After the asynchronous operation completes, check the Status property of the result to determine whether the operation succeeded with GameSaveErrorStatus.Ok.

Applies to

Share via