StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сообщает о потребляемой надстройке для текущего приложения, выполненной в 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)Параметры
- productStoreId
-
String
Platform::String
winrt::hstring
Идентификатор потребляемой надстройки в Магазине, о которой вы хотите сообщить, что выполнено.
- quantity
-
UInt32
unsigned int
uint32_t
Количество единиц потребляемой надстройки, о которой вы хотите сообщить, как выполненные. Для потребляемого объекта, управляемого Магазином (то есть потребляемого объекта, в котором корпорация Майкрософт отслеживает баланс) укажите количество использованных единиц. Для потребляемого объекта, управляемого разработчиком (т. е. потребляемого объекта, в котором разработчик отслеживает баланс) укажите значение 1.
- trackingId
-
Guid
Platform::Guid
winrt::guid
Предоставленный разработчиком GUID, который идентифицирует конкретную транзакцию, с которым связана операция исполнения для целей отслеживания. Дополнительные сведения см. в примечаниях.
Возвращаемое значение
Асинхронная операция, которая при успешном завершении возвращает объект StoreConsumableResult , содержащий сведения об операции выполнения, например оставшийся баланс дополнительных единиц.
- Атрибуты
Комментарии
После того как пользователь использует потребляемую надстройку в приложении, используйте этот метод, чтобы сообщить о том, что надстройка выполнена в Microsoft Store. Идентификатор магазина для надстройки доступен в Центре партнеров и возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку. Дополнительные сведения об использовании этого метода, включая пример кода, см. в разделе Включение покупок потребляемых надстроек.
Параметр trackingId используется, чтобы гарантировать, что каждая операция выполнения выполняется ровно один раз в Microsoft Store. Например, рассмотрим сценарий, в котором вы вызываете ReportConsumableFulfillmentAsync с заданной парой значений productStoreId и trackingId , Microsoft Store успешно помечает потребляемый объект как выполненный, но существует проблема с сетевым подключением, которая не позволяет приложению получать и обрабатывать ответ. Когда приложение в следующий раз повторит тот же вызов ReportConsumableFulfillmentAsync с той же парой значений productStoreId и trackingId после восстановления подключения, Microsoft Store сообщит об успешной транзакции, не взимая плату с пользователя снова. Параметр trackingId можно получить с помощью свойства TrackingIdвозвращаемого значения StoreConsumableResult .