StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Метод

Определение

Пространство имен:

Windows.Services.Store

Сообщает о потребляемой надстройке для текущего приложения, выполненной в 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, который идентифицирует конкретную транзакцию, с которым связана операция исполнения для целей отслеживания. Дополнительные сведения см. в примечаниях.

Возвращаемое значение

IAsyncOperation<StoreConsumableResult>

Асинхронная операция, которая при успешном завершении возвращает объект StoreConsumableResult , содержащий сведения об операции выполнения, например оставшийся баланс дополнительных единиц.

Атрибуты

RemoteAsyncAttribute

Комментарии

После того как пользователь использует потребляемую надстройку в приложении, используйте этот метод, чтобы сообщить о том, что надстройка выполнена в Microsoft Store. Идентификатор магазина для надстройки доступен в Центре партнеров и возвращается свойством StoreIdобъекта StoreProduct , представляющего надстройку. Дополнительные сведения об использовании этого метода, включая пример кода, см. в разделе Включение покупок потребляемых надстроек.

Параметр trackingId используется, чтобы гарантировать, что каждая операция выполнения выполняется ровно один раз в Microsoft Store. Например, рассмотрим сценарий, в котором вы вызываете ReportConsumableFulfillmentAsync с заданной парой значений productStoreId и trackingId , Microsoft Store успешно помечает потребляемый объект как выполненный, но существует проблема с сетевым подключением, которая не позволяет приложению получать и обрабатывать ответ. Когда приложение в следующий раз повторит тот же вызов ReportConsumableFulfillmentAsync с той же парой значений productStoreId и trackingId после восстановления подключения, Microsoft Store сообщит об успешной транзакции, не взимая плату с пользователя снова. Параметр trackingId можно получить с помощью свойства TrackingIdвозвращаемого значения StoreConsumableResult .

См. также раздел

• Поддержка покупок потребляемых надстроек
• Пример для Магазина