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 보다 페이지에서 더 적은 수의 항목을 반환할 수 있습니다.