StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Informa de un complemento consumible para la aplicación actual tal y como se cumple en 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)Parámetros
- productStoreId
-
String
Platform::String
winrt::hstring
Identificador de la Tienda del complemento consumible que quieres notificar como cumplido.
- quantity
-
UInt32
unsigned int
uint32_t
Número de unidades del complemento consumible que desea notificar como completada. Para un consumible administrado por la Tienda (es decir, un consumible en el que Microsoft realiza un seguimiento del saldo), especifique el número de unidades que se han consumido. Para un consumible administrado por el desarrollador (es decir, un consumible en el que el desarrollador realiza un seguimiento del saldo), especifique 1.
- trackingId
-
Guid
Platform::Guid
winrt::guid
Guid proporcionado por el desarrollador que identifica la transacción específica a la que está asociada la operación de cumplimiento con fines de seguimiento. Para obtener más información, vea los comentarios.
Devoluciones
Una operación asincrónica que, al finalizar correctamente, devuelve un objeto StoreConsumableResult que contiene información sobre la operación de suministro, como el saldo restante de unidades de complemento.
- Atributos
Comentarios
Una vez que el usuario ha usado un complemento consumible en la aplicación, usa este método para notificar el complemento como cumplido en Microsoft Store. El id. de la Tienda para el complemento está disponible en el Centro de partners y la propiedad StoreId de StoreProduct que representa el complemento. Para obtener más información sobre el uso de este método, incluido un ejemplo de código, vea Habilitar compras de complementos consumibles.
El parámetro trackingId se usa para ayudar a garantizar que la Microsoft Store controla exactamente una vez cada operación de suministro. Por ejemplo, considere un escenario en el que se llama a ReportConsumableFulfillmentAsync con un par determinado de valores productStoreId y trackingId , Microsoft Store marca correctamente el consumible como completado, pero hay un problema de conectividad de red que impide que la aplicación reciba y controle la respuesta. La próxima vez que la aplicación vuelva a intentar la misma llamada a ReportConsumableFulfillmentAsync con el mismo par de valores productStoreId y trackingId después de recuperar la conectividad, Microsoft Store notificará la transacción como correcta sin volver a cargar al usuario. El parámetro trackingId se puede recuperar a través de la propiedad TrackingId del valor devuelto StoreConsumableResult .