StoreContext.GetUserCollectionWithPagingAsync Methode

Definition

Namespace:

Windows.Services.Store

Ruft Microsoft Store-Informationen für die Add-Ons der aktuellen App ab, für die der Benutzer gekauft hat. Diese Methode unterstützt das Paging, um die Ergebnisse zurückzugeben.

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)

Parameter

productKinds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Ein Array von Zeichenfolgen, das die Typen von Add-Ons angibt, für die Sie Informationen abrufen möchten. Eine Liste der unterstützten Zeichenfolgenwerte finden Sie in der ProductKind-Eigenschaft.

maxItemsToRetrievePerPage

UInt32

unsigned int

uint32_t

Die maximale Anzahl von Add-Ons, die auf jeder Ergebnisseite zurückgegeben werden sollen.

Gibt zurück

IAsyncOperation<StoreProductPagedQueryResult>

Ein asynchroner Vorgang, der bei erfolgreicher Ausführung ein StoreProductPagedQueryResult-Objekt zurückgibt, das Zugriff auf die Microsoft Store-Informationen für die Add-Ons der aktuellen App bietet, für die der Benutzer erworben hat, sowie relevante Fehlerinformationen sowie die nächste Ergebnisseite.

Attribute

RemoteAsyncAttribute

Hinweise

Diese Methode ähnelt GetUserCollectionAsync, mit dem Unterschied, dass Sie paging verwenden können, um die Add-Ons abzurufen. Weitere Informationen zur Verwendung von GetUserCollectionAsync, einschließlich eines Codebeispiels, finden Sie unter Abrufen von Produktinformationen für Apps und Add-Ons.

Verwenden Sie hasMoreResults des StoreProductPagedQueryResult-Objekts , um zu bestimmen, ob zusätzliche Ergebnisseiten vorhanden sind, und verwenden Sie die GetNextAsync-Methode , um die nächste Ergebnisseite abzurufen.

Wenn der aktuelle Benutzer nicht beim Store angemeldet ist, gibt die ExtendedError-Eigenschaft des Rückgabewerts StoreProductPagedQueryResult den Fehlercode 0x80070525 (ERROR_NO_SUCH_USER) zurück.

Hinweis

Verwenden Sie Immer HasMoreResults , um zu ermitteln, ob mehr Seiten verfügbar sind, auch wenn die aktuelle Datenseite weniger Elemente enthält als maxItemsToRetrievePerPage. Um schnellere Ergebnisse zu erzielen, kann der Dienst weniger Elemente auf einer Seite zurückgeben als maxItemsToRetrievePerPage , auch wenn mehr Datenseiten verfügbar sind.