Compartir a través de


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

Definición

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 .

Se aplica a

Consulte también