StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Segnala un componente aggiuntivo di consumo per l'app corrente come evaso in 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)Parametri
- productStoreId
-
String
Platform::String
winrt::hstring
ID dello Store del componente aggiuntivo di consumo che vuoi segnalare come evaso.
- quantity
-
UInt32
unsigned int
uint32_t
Numero di unità del componente aggiuntivo di consumo che si desidera segnalare come soddisfatte. Per un componente di consumo gestito dallo Store (ovvero un componente di consumo in cui Microsoft tiene traccia del saldo), specificare il numero di unità utilizzate. Per un componente di consumo gestito dallo sviluppatore ,ovvero un componente di consumo in cui lo sviluppatore tiene traccia del saldo, specificare 1.
- trackingId
-
Guid
Platform::Guid
winrt::guid
GUID fornito dallo sviluppatore che identifica la transazione specifica a cui è associata l'operazione di evasione a scopo di rilevamento. Per altre informazioni, vedere le osservazioni.
Restituisce
Un'operazione asincrona che, al completamento, restituisce un oggetto StoreConsumableResult che contiene informazioni sull'operazione di evasione, ad esempio il saldo rimanente delle unità aggiuntive.
- Attributi
Commenti
Dopo che l'utente ha usato un componente aggiuntivo di consumo nella tua app, usa questo metodo per segnalare il componente aggiuntivo come evaso in Microsoft Store. L'ID dello Store per il componente aggiuntivo è disponibile nel Centro per i partner e viene restituito dalla proprietà StoreId di StoreProduct che rappresenta il componente aggiuntivo. Per altre informazioni sull'uso di questo metodo, incluso un esempio di codice, vedere Abilitare gli acquisti di componenti aggiuntivi di consumo.
Il parametro trackingId viene usato per garantire che ogni operazione di evasione venga gestita esattamente una volta da Microsoft Store. Si consideri ad esempio uno scenario in cui chiami ReportConsumableFulfillmentAsync con una determinata coppia di valori productStoreId e trackingId , Microsoft Store contrassegna correttamente il componente di consumo come evaso, ma esiste un problema di connettività di rete che impedisce all'app di ricevere e gestire la risposta. La volta successiva che l'app ritenta la stessa chiamata ReportConsumableFulfillmentAsync con la stessa coppia di valori productStoreId e trackingId dopo aver recuperato la connettività, Microsoft Store invierà la transazione come riuscita senza ricaricare nuovamente l'utente. Il parametro trackingId può essere recuperato tramite la proprietà TrackingId del valore restituito StoreConsumableResult .