StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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
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.