StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .