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가 잔액을 추적하는 소모성 제품인 Store 관리 소모품의 경우 사용된 단위 수를 지정합니다. 개발자가 관리하는 소모성 제품(즉, 개발자가 잔액을 추적하는 소모품)의 경우 1을 지정합니다.
- trackingId
-
Guid
Platform::Guid
winrt::guid
처리 작업이 추적 목적으로 연결된 특정 트랜잭션을 식별하는 개발자 제공 GUID 입니다. 자세한 내용은 설명을 참조하세요.
반환
성공적으로 완료될 때 나머지 추가 기능 단위 균형과 같은 처리 작업에 대한 정보가 포함된 StoreConsumableResult 개체를 반환하는 비동기 작업입니다.
- 특성
설명
사용자가 앱에서 소모성 추가 기능을 사용한 후 이 메서드를 사용하여 추가 기능을 Microsoft Store에서 처리된 것으로 보고합니다. 추가 기능에 대한 스토어 ID는 파트너 센터에서 사용할 수 있으며 추가 기능을 나타내는 StoreProduct의 StoreId 속성에 의해 반환됩니다. 코드 예제를 포함하여 이 메서드를 사용하는 방법에 대한 자세한 내용은 소모성 추가 기능 구매 사용을 참조하세요.
trackingId 매개 변수는 각 처리 작업이 Microsoft Store에서 정확히 한 번 처리되도록 하는 데 사용됩니다. 예를 들어 지정된 productStoreId 및 trackingId 값 쌍을 사용하여 ReportConsumableFulfillmentAsync를 호출하는 시나리오를 고려해 보세요. Microsoft Store는 소모성을 충족된 것으로 성공적으로 표시하지만 앱이 응답을 받고 처리하지 못하도록 하는 네트워크 연결 문제가 있습니다. 다음에 앱이 동일한 productStoreId 및 trackingId 값 쌍을 사용하여 동일한 ReportConsumableFulfillmentAsync 호출을 다시 시도하면 Microsoft Store는 사용자에게 다시 청구하지 않고 트랜잭션을 성공으로 보고합니다. trackingId 매개 변수는 StoreConsumableResult 반환 값의 TrackingId 속성을 통해 검색할 수 있습니다.