StoreContext.RequestPurchaseAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| RequestPurchaseAsync(String, StorePurchaseProperties) |
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。 この方法では、購入時にユーザーに表示する製品名など、Microsoft Store の 1 つの一覧で表される製品の大規模なカタログ内の特定のオファーの追加の詳細を指定するオプションを提供します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
| RequestPurchaseAsync(String) |
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。 重要 このメソッドは UI スレッドで呼び出す必要があります。 |
RequestPurchaseAsync(String, StorePurchaseProperties)
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。 この方法では、購入時にユーザーに表示する製品名など、Microsoft Store の 1 つの一覧で表される製品の大規模なカタログ内の特定のオファーの追加の詳細を指定するオプションを提供します。
重要
このメソッドは UI スレッドで呼び出す必要があります。
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId, StorePurchaseProperties ^ storePurchaseProperties) = RequestPurchaseAsync;/// [Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId, StorePurchaseProperties const& storePurchaseProperties);[Windows.Foundation.Metadata.Overload("RequestPurchaseWithPurchasePropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId, StorePurchaseProperties storePurchaseProperties);function requestPurchaseAsync(storeId, storePurchaseProperties)Public Function RequestPurchaseAsync (storeId As String, storePurchaseProperties As StorePurchaseProperties) As IAsyncOperation(Of StorePurchaseResult)パラメーター
- storeId
-
String
Platform::String
winrt::hstring
現在のユーザーに対して購入するアプリまたはアドオンのストア ID。
- storePurchaseProperties
- StorePurchaseProperties
購入時にユーザーに表示する製品名など、購入要求の追加情報を指定する オブジェクト。
戻り値
正常に完了すると、購入に関する状態とエラー情報を提供する StorePurchaseResult オブジェクトを返す非同期操作。
- 属性
例外
例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。
注釈
アプリまたはアドオンのストア ID はパートナー センターで使用でき、アプリまたはアドオンを表す StoreProduct の StoreId プロパティによって返されます。
こちらもご覧ください
適用対象
RequestPurchaseAsync(String)
指定したアプリまたはアドオンの購入を要求し、Microsoft Store 経由でトランザクションを完了するために使用される UI を表示します。
重要
このメソッドは UI スレッドで呼び出す必要があります。
public:
virtual IAsyncOperation<StorePurchaseResult ^> ^ RequestPurchaseAsync(Platform::String ^ storeId) = RequestPurchaseAsync;/// [Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(winrt::hstring const& storeId);[Windows.Foundation.Metadata.Overload("RequestPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorePurchaseResult> RequestPurchaseAsync(string storeId);function requestPurchaseAsync(storeId)Public Function RequestPurchaseAsync (storeId As String) As IAsyncOperation(Of StorePurchaseResult)パラメーター
- storeId
-
String
Platform::String
winrt::hstring
現在のユーザーに対して購入するアプリまたはアドオンのストア ID。
戻り値
正常に完了すると、購入に関する状態とエラー情報を提供する StorePurchaseResult オブジェクトを返す非同期操作。
- 属性
例外
例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。
注釈
コード例など、このメソッドの使用方法の詳細については、「 アプリとアドオンのアプリ内購入を有効にする」を参照してください。
アプリまたはアドオンのストア ID はパートナー センターで使用でき、アプリまたはアドオンを表す StoreProduct の StoreId プロパティによって返されます。