StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 回だけ処理されるようにするために使用されます。 たとえば、特定の productStoreId と trackingId 値のペアを使用して ReportConsumableFulfillmentAsync を呼び出すシナリオを考えると、Microsoft Store はコンシューマブルを満たしたものとして正常にマークしますが、アプリが応答を受信して処理できないネットワーク接続の問題があります。 次回、アプリが同じ ReportConsumableFulfillmentAsync 呼び出しを 同じ productStoreId と trackingId 値のペアで再試行すると、Microsoft Store は、ユーザーに再度課金することなく、トランザクションを成功として報告します。 trackingId パラメーターは、StoreConsumableResult の戻り値の TrackingId プロパティを使用して取得できます。