StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Methode

Definition

Namespace:

Windows.Services.Store

Meldet ein verbrauchsbares Add-On für die aktuelle App als erfüllt im Microsoft Store.

public:
 virtual IAsyncOperation<StoreConsumableResult ^> ^ ReportConsumableFulfillmentAsync(Platform::String ^ productStoreId, unsigned int quantity, Platform::Guid trackingId) = ReportConsumableFulfillmentAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StoreConsumableResult> ReportConsumableFulfillmentAsync(winrt::hstring const& productStoreId, uint32_t const& quantity, winrt::guid const& trackingId);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StoreConsumableResult> ReportConsumableFulfillmentAsync(string productStoreId, uint quantity, Guid trackingId);

function reportConsumableFulfillmentAsync(productStoreId, quantity, trackingId)

Public Function ReportConsumableFulfillmentAsync (productStoreId As String, quantity As UInteger, trackingId As Guid) As IAsyncOperation(Of StoreConsumableResult)

Parameter

productStoreId

String

Platform::String

winrt::hstring

Die Store-ID des verbrauchsbaren Add-Ons, das Sie als erfüllt melden möchten.

quantity

UInt32

unsigned int

uint32_t

Die Anzahl der Einheiten des verbrauchsbaren Add-Ons, die Sie als erfüllt melden möchten. Geben Sie für ein vom Store verwaltetes Verbrauchsmaterial (d. h. ein Verbrauchsmaterial, bei dem Microsoft den Saldo nachverfolgt) die Anzahl der verbrauchten Einheiten an. Geben Sie für ein vom Entwickler verwaltetes Verbrauchsmaterial (d. h. ein Verbrauchsmaterial, bei dem der Entwickler die Balance nachverfolgt), 1 an.

trackingId

Guid

Platform::Guid

winrt::guid

Eine vom Entwickler bereitgestellte GUID , die die spezifische Transaktion identifiziert, der der Fulfillmentvorgang zu Nachverfolgungszwecken zugeordnet ist. Weitere Informationen finden Sie in den Anmerkungen.

Gibt zurück

IAsyncOperation<StoreConsumableResult>

Ein asynchroner Vorgang, der bei erfolgreicher Fertigstellung ein StoreConsumableResult-Objekt zurückgibt, das Informationen zum Fulfillmentvorgang enthält, z. B. den verbleibenden Saldo von Add-On-Einheiten.

Attribute

RemoteAsyncAttribute

Hinweise

Nachdem der Benutzer ein verbrauchsbares Add-On in Ihrer App verwendet hat, verwenden Sie diese Methode, um das Add-On im Microsoft Store als erfüllt zu melden. Die Store-ID für das Add-On ist in Partner Center verfügbar und wird von der StoreId-Eigenschaft des StoreProduct zurückgegeben, das das Add-On darstellt. Weitere Informationen zur Verwendung dieser Methode, einschließlich eines Codebeispiels, finden Sie unter Aktivieren von Verbrauchs-Add-On-Käufen.

Der Parameter trackingId wird verwendet, um sicherzustellen, dass jeder Fulfillmentvorgang genau einmal vom Microsoft Store verarbeitet wird. Betrachten Sie beispielsweise ein Szenario, in dem Sie ReportConsumableFulfillmentAsync mit einem bestimmten Paar von productStoreId - und trackingId-Werten aufrufen. Der Microsoft Store markiert das Verbrauchsmaterial erfolgreich als erfüllt, aber es gibt ein Netzwerkkonnektivitätsproblem, das verhindert, dass Ihre App die Antwort empfängt und verarbeitet. Wenn Ihre App das nächste Mal denselben ReportConsumableFulfillmentAsync-Aufruf mit demselben Paar von productStoreId - und trackingId-Werten wiederholt, nachdem sie die Konnektivität wieder hergestellt hat, meldet der Microsoft Store die Transaktion als erfolgreich, ohne dass der Benutzer erneut aufgeladen wird. Der trackingId-Parameter kann über die TrackingId-Eigenschaft des StoreConsumableResult-Rückgabewerts abgerufen werden.

Weitere Informationen

• Unterstützen von Endverbraucher-Add-On-Käufen
• Store-Beispiel