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

フルフィルメント済みとして報告するコンシューマブル アドオンのストア ID。

quantity
UInt32

unsigned int

uint32_t

フルフィルメント済みとして報告するコンシューマブル アドオンのユニット数。 ストアで管理されるコンシューマブル (つまり、Microsoft が残高を追跡するコンシューマブル) の場合は、消費されたユニットの数を指定します。 開発者が管理するコンシューマブル (つまり、開発者が残高を追跡するコンシューマブル) の場合は、1 を指定します。

trackingId
Guid

Platform::Guid

winrt::guid

フルフィルメント操作が追跡目的で関連付けられている特定のトランザクションを識別する開発者が指定した GUID 。 詳細については、備考を参照してください。

戻り値

正常に完了すると、アドオン ユニットの残りの残高など、フルフィルメント操作に関する情報を含む StoreConsumableResult オブジェクトを返す非同期操作。

属性

注釈

ユーザーがアプリでコンシューマブル アドオンを使用した後、このメソッドを使用して、Microsoft Store で満たされたアドオンを報告します。 アドオンのストア ID はパートナー センターで使用でき、アドオンを表す StoreProduct の StoreId プロパティによって返されます。 コード例など、このメソッドの使用方法の詳細については、「 コンシューマブル アドオン購入を有効にする」を参照してください。

trackingId パラメーターは、各フルフィルメント操作が Microsoft Store によって 1 回だけ処理されるようにするために使用されます。 たとえば、特定の productStoreIdtrackingId 値のペアを使用して ReportConsumableFulfillmentAsync を呼び出すシナリオを考えると、Microsoft Store はコンシューマブルを満たしたものとして正常にマークしますが、アプリが応答を受信して処理できないネットワーク接続の問題があります。 次回、アプリが同じ ReportConsumableFulfillmentAsync 呼び出しを 同じ productStoreIdtrackingId 値のペアで再試行すると、Microsoft Store は、ユーザーに再度課金することなく、トランザクションを成功として報告します。 trackingId パラメーターは、StoreConsumableResult の戻り値の TrackingId プロパティを使用して取得できます。

適用対象

こちらもご覧ください