CurrentApp.RequestAppPurchaseAsync | requestAppPurchaseAsync Method

建立非同步作業,可讓使用者購買目前應用程式的完整授權。

語法


public static IAsyncOperation<string> RequestAppPurchaseAsync(
  bool includeReceipt
)

參數

includeReceipt

型別: Boolean [JavaScript] | System.Boolean [.NET] | Platform::Boolean [C++]

判斷此方法是否應該傳回這個應用程式的收據。

傳回值

型別: IAsyncOperation<String>

如果 includeReceipt 參數設定為 true,此字串會包含代表應用程式和任何應用程式中購買之所有收據的 XML。如果 includeReceipt 設定為 false,則這個字串會是空的。

備註

這個方法會傳回成功值,即使:

  • 沒有可用的網路連線
  • 使用者在對話方塊之外取消
  • 此使用者的驗證失敗
您應該將成功的結果視為表示非同步處理已完成,且未發生錯誤。若要確保交易本身成功,請檢查傳回回條中的 LicenseInformation 項目。

這個方法傳回的 XML 格式字串會使用這些項目:

項目名稱描述子項目屬性
回條包含應用程式購買和應用程式中購買的相關資訊。

AppReceipt

ProductReceipt

簽章

Version:收據的版本號碼。

CertificateId:用來簽署收據的憑證指模。

ReceiptDate:回條簽署並下載的日期。

ReceiptDeviceId:識別用來要求這個回條的裝置。

AppReceipt包含應用程式購買的相關資訊。無。

Id:識別購買。

AppId:作業系統用於應用程式的 [套件家族名稱] 值。

LicenseType:如果使用者購買完整版的應用程式,則為完整。試用版,如果使用者已下載應用程式的試用版。

PurchaseDate:取得應用程式的日期。

ProductReceipt包含應用程式中購買的相關資訊。無。

Id:識別購買。

AppId:識別使用者購買時所使用的應用程式。

ProductId:識別購買的產品。

ProductType:決定產品類型。目前僅支援 Durable 這個值。

PurchaseDate:購買發生的日期。

簽章包含回條的簽章和如何數位簽署回條的資訊。

SignedInfo

SignatureValue

這個項目是標準的 XML-DSIG 建構。它包含 SignatureValue 項目,其中包含可用來驗證回條的簽章。

 

若要驗證回條的真實性,您可以使用公開憑證檢查回條的簽章。若要取得這個憑證,請使用下列 URL:

https://go.microsoft.com/fwlink/p/?linkid=246509&cid=<CertificateId>

其中 <CertificateId> 是回條的 CertificateId

Windows Phone 8

這個應用程式開發介面不會實作,而且如果呼叫的話,會擲回例外狀況。請參閱 Windows Phone 執行階段 API

需求

支援的最小用戶端

Windows 8

支援的最小伺服器

Windows Server 2012

命名空間

Windows.ApplicationModel.Store
Windows::ApplicationModel::Store [C++]

Metadata

Windows.winmd

請參閱

CurrentApp

 

 

顯示:
© 2015 Microsoft