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

처리된 것으로 보고하려는 소모성 추가 기능의 스토어 ID입니다.

quantity

UInt32

unsigned int

uint32_t

처리된 것으로 보고하려는 소모성 추가 기능의 단위 수입니다. Microsoft가 잔액을 추적하는 소모성 제품인 Store 관리 소모품의 경우 사용된 단위 수를 지정합니다. 개발자가 관리하는 소모성 제품(즉, 개발자가 잔액을 추적하는 소모품)의 경우 1을 지정합니다.

trackingId

Guid

Platform::Guid

winrt::guid

처리 작업이 추적 목적으로 연결된 특정 트랜잭션을 식별하는 개발자 제공 GUID 입니다. 자세한 내용은 설명을 참조하세요.

반환

IAsyncOperation<StoreConsumableResult>

성공적으로 완료될 때 나머지 추가 기능 단위 균형과 같은 처리 작업에 대한 정보가 포함된 StoreConsumableResult 개체를 반환하는 비동기 작업입니다.

특성

RemoteAsyncAttribute

설명

사용자가 앱에서 소모성 추가 기능을 사용한 후 이 메서드를 사용하여 추가 기능을 Microsoft Store에서 처리된 것으로 보고합니다. 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 추가 기능을 나타내는 StoreProduct의 StoreId 속성에 의해 반환됩니다. 코드 예제를 포함하여 이 메서드를 사용하는 방법에 대한 자세한 내용은 소모성 추가 기능 구매 사용을 참조하세요.

trackingId 매개 변수는 각 처리 작업이 Microsoft Store에서 정확히 한 번 처리되도록 하는 데 사용됩니다. 예를 들어 지정된 productStoreId 및 trackingId 값 쌍을 사용하여 ReportConsumableFulfillmentAsync를 호출하는 시나리오를 고려해 보세요. Microsoft Store는 소모성을 충족된 것으로 성공적으로 표시하지만 앱이 응답을 받고 처리하지 못하도록 하는 네트워크 연결 문제가 있습니다. 다음에 앱이 동일한 productStoreId 및 trackingId 값 쌍을 사용하여 동일한 ReportConsumableFulfillmentAsync 호출을 다시 시도하면 Microsoft Store는 사용자에게 다시 청구하지 않고 트랜잭션을 성공으로 보고합니다. trackingId 매개 변수는 StoreConsumableResult 반환 값의 TrackingId 속성을 통해 검색할 수 있습니다.

추가 정보

• 소모성 추가 기능 구매 사용
• 스토어 샘플