StoreContext.RequestPurchaseAsync 方法

定義

命名空間:

Windows.Services.Store

多載

RequestPurchaseAsync(String, StorePurchaseProperties)	要求購買指定的應用程式或附加元件，並顯示用來透過 Microsoft Store 完成交易的 UI。 這個方法提供選項，以在 Microsoft Store 中的單一清單所代表的大型產品目錄中，指定特定供應專案的其他詳細資料，包括在購買期間向使用者顯示的產品名稱。 重要 這個方法必須在 UI 執行緒上呼叫。
RequestPurchaseAsync(String)	要求購買指定的應用程式或附加元件，並顯示用來透過 Microsoft Store 完成交易的 UI。 重要 這個方法必須在 UI 執行緒上呼叫。

RequestPurchaseAsync(String, StorePurchaseProperties)

要求購買指定的應用程式或附加元件，並顯示用來透過 Microsoft Store 完成交易的 UI。 這個方法提供選項，以在 Microsoft Store 中的單一清單所代表的大型產品目錄中，指定特定供應專案的其他詳細資料，包括在購買期間向使用者顯示的產品名稱。

重要

這個方法必須在 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

您想要為目前使用者購買的應用程式或附加元件的市集識別碼。

storePurchaseProperties

StorePurchaseProperties

物件，指定購買要求的其他資訊，包括購買期間要向使用者顯示的產品名稱。

傳回

IAsyncOperation<StorePurchaseResult>

成功完成時，非同步作業會傳回 StorePurchaseResult 物件，該物件提供購買的狀態和錯誤資訊。

屬性

OverloadAttribute RemoteAsyncAttribute

例外狀況

COMException

如果例外狀況的 ErrorCode 屬性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，這表示未在 UI 執行緒上呼叫方法。 如果您在使用 傳統型橋接器 的桌面應用程式中呼叫這個方法，這也表示您未 < 設定 xref：Windows.Services.Store.StoreCoNtext？text=StoreCoNtext > 物件，以指定哪一個應用程式視窗是此方法所顯示模式對話方塊的擁有者視窗。 如需詳細資訊，請參閱這篇文章。

備註

應用程式或附加元件的市集識別碼可在合作夥伴中心取得，而StoreProduct 的 StoreId屬性會傳回代表應用程式或附加元件的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

您想要為目前使用者購買的應用程式或附加元件的市集識別碼。

傳回

IAsyncOperation<StorePurchaseResult>

成功完成時，非同步作業會傳回 StorePurchaseResult 物件，該物件提供購買的狀態和錯誤資訊。

屬性

OverloadAttribute RemoteAsyncAttribute

例外狀況

COMException

如果例外狀況的 ErrorCode 屬性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，這表示未在 UI 執行緒上呼叫方法。 如果您在使用 傳統型橋接器 的桌面應用程式中呼叫這個方法，這也表示您未 < 設定 xref：Windows.Services.Store.StoreCoNtext？text=StoreCoNtext > 物件，以指定哪一個應用程式視窗是此方法所顯示模式對話方塊的擁有者視窗。 如需詳細資訊，請參閱這篇文章。

備註

如需使用此方法的詳細資訊，包括程式碼範例，請參閱 啟用應用程式內購買應用程式和附加元件。

應用程式或附加元件的市集識別碼可在合作夥伴中心取得，而StoreProduct 的 StoreId屬性會傳回代表應用程式或附加元件的StoreId屬性。

另請參閱

• RequestPurchaseAsync(String, StorePurchaseProperties)
• 啟用應用程式和附加元件的應用程式內購買