Compartilhar via


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

Definição

Relata um complemento consumível para o aplicativo atual, conforme atendido na 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

A ID da Loja do complemento consumível que você deseja relatar conforme atendido.

quantity
UInt32

unsigned int

uint32_t

O número de unidades do complemento consumível que você deseja relatar conforme atendido. Para um consumível gerenciado pela Store (ou seja, um consumível em que a Microsoft mantém o controle do saldo), especifique o número de unidades que foram consumidas. Para um consumível gerenciado pelo desenvolvedor (ou seja, um consumível em que o desenvolvedor mantém o controle do saldo), especifique 1.

trackingId
Guid

Platform::Guid

winrt::guid

Um GUID fornecido pelo desenvolvedor que identifica a transação específica à qual a operação de cumprimento está associada para fins de acompanhamento. Para obter mais informações, consulte os comentários.

Retornos

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StoreConsumableResult que contém informações sobre a operação de cumprimento, como o saldo restante das unidades complementares.

Atributos

Comentários

Depois que o usuário tiver usado um complemento consumível em seu aplicativo, use esse método para relatar o complemento conforme atendido na Microsoft Store. A ID da Loja para o complemento está disponível no Partner Center e é retornada pela propriedade StoreId do StoreProduct que representa o complemento. Para obter mais informações sobre como usar esse método, incluindo um exemplo de código, consulte Habilitar compras de complementos consumíveis.

O parâmetro trackingId é usado para ajudar a garantir que cada operação de cumprimento seja tratada exatamente uma vez pela Microsoft Store. Por exemplo, considere um cenário em que você chama ReportConsumableFulfillmentAsync com um determinado par de valores productStoreId e trackingId , a Microsoft Store marca com êxito o consumível como atendido, mas há um problema de conectividade de rede que impede que seu aplicativo receba e manifique a resposta. Na próxima vez que seu aplicativo tentar novamente a mesma chamada ReportConsumableFulfillmentAsync com o mesmo par de valores productStoreId e trackingId depois de recuperar a conectividade, a Microsoft Store relatará a transação como bem-sucedida sem cobrar o usuário novamente. O parâmetro trackingId pode ser recuperado por meio da propriedade TrackingId do valor retornado StoreConsumableResult .

Aplica-se a

Confira também