Freigeben über


StoreContext.RequestPurchaseAsync Methode

Definition

Überlädt

RequestPurchaseAsync(String, StorePurchaseProperties)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. Diese Methode bietet die Möglichkeit, zusätzliche Details für ein bestimmtes Angebot in einem großen Katalog von Produkten anzugeben, die durch einen einzelnen Eintrag im Microsoft Store dargestellt werden, einschließlich des Produktnamens, der dem Benutzer während des Kaufs angezeigt werden soll.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestPurchaseAsync(String)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestPurchaseAsync(String, StorePurchaseProperties)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird. Diese Methode bietet die Möglichkeit, zusätzliche Details für ein bestimmtes Angebot in einem großen Katalog von Produkten anzugeben, die durch einen einzelnen Eintrag im Microsoft Store dargestellt werden, einschließlich des Produktnamens, der dem Benutzer während des Kaufs angezeigt werden soll.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

public:
 virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId, StorePurchaseProperties ^ storePurchaseProperties) = RequestPurchaseAsync;
/// [Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId, StorePurchaseProperties const& storePurchaseProperties);
[Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId, StorePurchaseProperties storePurchaseProperties);
function requestPurchaseAsync(storeId, storePurchaseProperties)
Public Function RequestPurchaseAsync (storeId As String, storePurchaseProperties As StorePurchaseProperties) As IAsyncOperation(Of StorePurchaseResult)

Parameter

storeId
String

Platform::String

winrt::hstring

Die Store-ID der App oder des Add-Ons, das Sie für den aktuellen Benutzer erwerben möchten.

storePurchaseProperties
StorePurchaseProperties

Ein -Objekt, das zusätzliche Informationen für die Kaufanforderung angibt, einschließlich des Produktnamens, der dem Benutzer während des Kaufs angezeigt werden soll.

Gibt zurück

Ein asynchroner Vorgang, der bei erfolgreicher Ausführung ein StorePurchaseResult-Objekt zurückgibt, das status- und Fehlerinformationen zum Kauf bereitstellt.

Attribute

Ausnahmen

Wenn die ErrorCode-Eigenschaft der Ausnahme den Wert 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) aufweist, gibt dies an, dass die Methode im UI-Thread nicht aufgerufen wurde. Wenn Sie diese Methode in einer Desktopanwendung aufrufen, die die Desktop-Brücke verwendet, kann dies auch darauf hinweisen, dass Sie das <xref:Windows.Services.Store.StoreContext?text=StoreContext-Objekt> nicht konfiguriert haben, um anzugeben, welches Anwendungsfenster das Besitzerfenster für modale Dialoge ist, die von dieser Methode angezeigt werden. hier finden Sie weitere Informationen

Hinweise

Die Store-ID für eine App oder ein Add-On ist im Partner Center verfügbar und wird von der StoreId-Eigenschaft des StoreProduct zurückgegeben, das die App oder das Add-On darstellt.

Weitere Informationen

Gilt für:

RequestPurchaseAsync(String)

Fordert den Kauf für die angegebene App oder das angegebene Add-On an und zeigt die Benutzeroberfläche an, die zum Abschließen der Transaktion über den Microsoft Store verwendet wird.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

public:
 virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId) = RequestPurchaseAsync;
/// [Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId);
[Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId);
function requestPurchaseAsync(storeId)
Public Function RequestPurchaseAsync (storeId As String) As IAsyncOperation(Of StorePurchaseResult)

Parameter

storeId
String

Platform::String

winrt::hstring

Die Store-ID der App oder des Add-Ons, das Sie für den aktuellen Benutzer erwerben möchten.

Gibt zurück

Ein asynchroner Vorgang, der bei erfolgreicher Ausführung ein StorePurchaseResult-Objekt zurückgibt, das status- und Fehlerinformationen zum Kauf bereitstellt.

Attribute

Ausnahmen

Wenn die ErrorCode-Eigenschaft der Ausnahme den Wert 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) aufweist, gibt dies an, dass die Methode im UI-Thread nicht aufgerufen wurde. Wenn Sie diese Methode in einer Desktopanwendung aufrufen, die die Desktop-Brücke verwendet, kann dies auch darauf hinweisen, dass Sie das <xref:Windows.Services.Store.StoreContext?text=StoreContext-Objekt> nicht konfiguriert haben, um anzugeben, welches Anwendungsfenster das Besitzerfenster für modale Dialoge ist, die von dieser Methode angezeigt werden. hier finden Sie weitere Informationen

Hinweise

Weitere Informationen zur Verwendung dieser Methode, einschließlich eines Codebeispiels, finden Sie unter Aktivieren von In-App-Käufen von Apps und Add-Ons.

Die Store-ID für eine App oder ein Add-On ist im Partner Center verfügbar und wird von der StoreId-Eigenschaft des StoreProduct zurückgegeben, das die App oder das Add-On darstellt.

Weitere Informationen

Gilt für: