StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Metodo

Definizione

Spazio dei nomi:

Windows.Services.Store

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

IAsyncOperation<StoreConsumableResult>

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

RemoteAsyncAttribute

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 .

Vedi anche

• Abilitare gli acquisti di componenti aggiuntivi di consumo
• Esempio dello Store