StoreContext.GetUserCollectionWithPagingAsync メソッド

定義

名前空間:

Windows.Services.Store

ユーザーが購入した現在のアプリのアドオンの Microsoft Store 情報を取得します。 このメソッドは、結果を返すページングをサポートしています。

public:
 virtual IAsyncOperation<StoreProductPagedQueryResult ^> ^ GetUserCollectionWithPagingAsync(IIterable<Platform::String ^> ^ productKinds, unsigned int maxItemsToRetrievePerPage) = GetUserCollectionWithPagingAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StoreProductPagedQueryResult> GetUserCollectionWithPagingAsync(IIterable<winrt::hstring> const& productKinds, uint32_t const& maxItemsToRetrievePerPage);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StoreProductPagedQueryResult> GetUserCollectionWithPagingAsync(IEnumerable<string> productKinds, uint maxItemsToRetrievePerPage);

function getUserCollectionWithPagingAsync(productKinds, maxItemsToRetrievePerPage)

Public Function GetUserCollectionWithPagingAsync (productKinds As IEnumerable(Of String), maxItemsToRetrievePerPage As UInteger) As IAsyncOperation(Of StoreProductPagedQueryResult)

パラメーター

productKinds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

情報を取得するアドオンの種類を指定する文字列の配列。 サポートされている文字列値の一覧についてはProductKind プロパティをご覧ください。

maxItemsToRetrievePerPage

UInt32

unsigned int

uint32_t

結果の各ページで返されるアドオンの最大数。

戻り値

IAsyncOperation<StoreProductPagedQueryResult>

正常に完了すると、ユーザーが購入した現在のアプリのアドオンと関連するエラー情報、および結果の次のページの Microsoft Store 情報へのアクセスを提供する StoreProductPagedQueryResult オブジェクトを返す非同期操作。

属性

RemoteAsyncAttribute

注釈

このメソッドは GetUserCollectionAsync に似ていますが、ページングを使用してアドオンを取得できる点が異なります。 コード例を含む GetUserCollectionAsync の使用方法の詳細については、「 アプリとアドオンの製品情報を取得する」を参照してください。

StoreProductPagedQueryResult オブジェクトの HasMoreResults を使用して、結果のページが追加されているかどうかを確認し、GetNextAsync メソッドを使用して結果の次のページを取得します。

現在のユーザーが Store にサインインしていない場合、StoreProductPagedQueryResult 戻り値の ExtendedError プロパティはエラー コード 0x80070525 (ERROR_NO_SUCH_USER) を返します。

注意

データの現在のページに含まれる項目が maxItemsToRetrievePerPage よりも少ない場合でも、使用可能なページ数が多いかどうかを判断するには、常に HasMoreResults を使用します。 より高速な結果を得るために、使用可能なデータページが多い場合でも、サービスは maxItemsToRetrievePerPage よりもページ内のアイテムを少なく返すことができます。