StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Méthode

Définition

Espace de noms:

Windows.Services.Store

Signale un module complémentaire consommable pour l’application actuelle tel qu’il est rempli dans le 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)

Paramètres

productStoreId

String

Platform::String

winrt::hstring

ID store du module complémentaire consommable que vous souhaitez signaler comme rempli.

quantity

UInt32

unsigned int

uint32_t

Nombre d’unités du module complémentaire consommable que vous souhaitez signaler comme remplies. Pour un consommable géré par le Store (c’est-à-dire un consommable dans lequel Microsoft effectue le suivi du solde), spécifiez le nombre d’unités qui ont été consommées. Pour un consommable géré par le développeur (autrement dit, un consommable dans lequel le développeur effectue le suivi du solde), spécifiez 1.

trackingId

Guid

Platform::Guid

winrt::guid

GUID fourni par le développeur qui identifie la transaction spécifique à laquelle l’opération de traitement est associée à des fins de suivi. Pour plus d’informations, consultez les remarques.

Retours

IAsyncOperation<StoreConsumableResult>

Opération asynchrone qui, une fois l’achèvement réussi, retourne un objet StoreConsumableResult qui contient des informations sur l’opération de traitement, telles que le solde restant des unités de module complémentaire.

Attributs

RemoteAsyncAttribute

Remarques

Une fois que l’utilisateur a utilisé un module complémentaire consommable dans votre application, utilisez cette méthode pour signaler l’extension comme étant remplie dans le Microsoft Store. L’ID Store du module complémentaire est disponible dans l’Espace partenaires et il est retourné par la propriété StoreId du StoreProduct qui représente le module complémentaire. Pour plus d’informations sur l’utilisation de cette méthode, y compris un exemple de code, consultez Activer les achats de modules complémentaires consommables.

Le paramètre trackingId est utilisé pour garantir que chaque opération de traitement est gérée exactement une fois par le Microsoft Store. Par exemple, dans un scénario où vous appelez ReportConsumableFulfillmentAsync avec une paire donnée de valeurs productStoreId et trackingId , le Microsoft Store marque correctement le consommable comme étant rempli, mais il existe un problème de connectivité réseau qui empêche votre application de recevoir et de gérer la réponse. La prochaine fois que votre application retente le même appel ReportConsumableFulfillmentAsync avec la même paire de valeurs productStoreId et trackingId une fois la connectivité rétablie, le Microsoft Store signale que la transaction a réussi sans facturer à nouveau l’utilisateur. Le paramètre trackingId peut être récupéré via la propriété TrackingId de la valeur de retour StoreConsumableResult .

Voir aussi

• Activer les achats de modules complémentaires consommables
• Exemple Store