StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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
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 .