StoreContext.ReportConsumableFulfillmentAsync(String, UInt32, Guid) Metode

Definisi

Ruang nama:

Windows.Services.Store

Melaporkan add-on yang dapat dikonsumsi untuk aplikasi saat ini seperti yang terpenuhi di 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)

Parameter

productStoreId

String

Platform::String

winrt::hstring

ID Penyimpanan add-on yang dapat dikonsumsi yang ingin Anda laporkan sebagai terpenuhi.

quantity

UInt32

unsigned int

uint32_t

Jumlah unit add-on yang dapat dikonsumsi yang ingin Anda laporkan sebagai terpenuhi. Untuk Penyimpanan yang dapat dikonsumsi (yaitu, yang dapat digunakan di mana Microsoft melacak keseimbangan), tentukan jumlah unit yang telah digunakan. Untuk konsumsi yang dikelola pengembang (yaitu, dapat dikonsumsi di mana pengembang melacak keseimbangan), tentukan 1.

trackingId

Guid

Platform::Guid

winrt::guid

GUID yang disediakan pengembang yang mengidentifikasi transaksi tertentu yang dikaitkan dengan operasi pemenuhan untuk tujuan pelacakan. Untuk informasi selengkapnya, lihat keterangan.

Mengembalikan

IAsyncOperation<StoreConsumableResult>

Operasi asinkron yang, setelah berhasil diselesaikan, mengembalikan objek StoreConsumableResult yang berisi info tentang operasi pemenuhan, seperti sisa saldo unit add-on.

Atribut

RemoteAsyncAttribute

Keterangan

Setelah pengguna menggunakan add-on yang dapat dikonsumsi di aplikasi Anda, gunakan metode ini untuk melaporkan add-on seperti yang terpenuhi di Microsoft Store. ID Toko untuk add-on tersedia di Pusat Mitra, dan dikembalikan oleh properti StoreId dari StoreProduct yang mewakili add-on. Untuk informasi selengkapnya tentang menggunakan metode ini, termasuk contoh kode, lihat Mengaktifkan pembelian add-on yang dapat digunakan.

Parameter trackingId digunakan untuk membantu memastikan bahwa setiap operasi pemenuhan ditangani tepat sekali oleh Microsoft Store. Misalnya, pertimbangkan skenario di mana Anda memanggil ReportConsumableFulfillmentAsync dengan sepasang nilai productStoreId dan trackingId tertentu, Microsoft Store berhasil menandai konsumsi sebagai terpenuhi, tetapi ada masalah konektivitas jaringan yang mencegah aplikasi Anda menerima dan menangani respons. Saat berikutnya aplikasi Anda mencoba kembali panggilan ReportConsumableFulfillmentAsync yang sama dengan pasangan nilai productStoreId dan trackingId yang sama setelah mendapatkan kembali konektivitas, Microsoft Store akan melaporkan transaksi yang berhasil tanpa menagih pengguna lagi. Parameter trackingId dapat diambil melalui properti TrackingId dari nilai pengembalian StoreConsumableResult .

Lihat juga

• Mengaktifkan pembelian add-on yang dapat dikonsumsi
• Simpan sampel