StoreContext.RequestPurchaseAsync メソッド

定義

名前空間:

Windows.Services.Store

オーバーロード

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

購入時にユーザーに表示する製品名など、購入要求の追加情報を指定する オブジェクト。

戻り値

IAsyncOperation<StorePurchaseResult>

正常に完了すると、購入に関する状態とエラー情報を提供する StorePurchaseResult オブジェクトを返す非同期操作。

属性

OverloadAttribute RemoteAsyncAttribute

例外

COMException

例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。

注釈

アプリまたはアドオンのストア ID はパートナー センターで使用でき、アプリまたはアドオンを表す StoreProduct の StoreId プロパティによって返されます。

こちらもご覧ください

• RequestPurchaseAsync(String)
• アプリとアドオンのアプリ内購入の有効化

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。

戻り値

IAsyncOperation<StorePurchaseResult>

正常に完了すると、購入に関する状態とエラー情報を提供する StorePurchaseResult オブジェクトを返す非同期操作。

属性

OverloadAttribute RemoteAsyncAttribute

例外

COMException

例外の ErrorCode プロパティの値が 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) の場合は、UI スレッドで メソッドが呼び出されなかったことを示します。 デスクトップ ブリッジを使用するデスクトップ アプリケーションでこのメソッドを呼び出す場合は、xref:Windows.Services.Store.StoreContext?text=StoreContext> オブジェクトを構成<して、このメソッドによって表示されるモーダル ダイアログの所有者ウィンドウであるアプリケーション ウィンドウを指定しなかったことも示すことができます。 詳細については、 こちらの記事を参照してください。

注釈

コード例など、このメソッドの使用方法の詳細については、「 アプリとアドオンのアプリ内購入を有効にする」を参照してください。

アプリまたはアドオンのストア ID はパートナー センターで使用でき、アプリまたはアドオンを表す StoreProduct の StoreId プロパティによって返されます。

こちらもご覧ください

• RequestPurchaseAsync(String, StorePurchaseProperties)
• アプリとアドオンのアプリ内購入の有効化