StoreContext.RequestPurchaseAsync Método

  • Referência

Definição

Namespace:
Windows.Services.Store

Sobrecargas

RequestPurchaseAsync(String, StorePurchaseProperties)

Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica em um grande catálogo de produtos que são representados por uma única listagem na Microsoft Store, incluindo o nome do produto a ser exibido ao usuário durante a compra.

Importante

Esse método deve ser chamado no thread da interface do usuário.
RequestPurchaseAsync(String)

Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store.

Importante

Esse método deve ser chamado no thread da interface do usuário.

RequestPurchaseAsync(String, StorePurchaseProperties)

Editar

Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica em um grande catálogo de produtos que são representados por uma única listagem na Microsoft Store, incluindo o nome do produto a ser exibido ao usuário durante a compra.

Importante

Esse método deve ser chamado no thread da interface do usuário.

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)

Parâmetros

storeId
String

Platform::String

winrt::hstring

A ID da Loja do aplicativo ou o complemento que você deseja comprar para o usuário atual.

storePurchaseProperties
StorePurchaseProperties

Um objeto que especifica informações adicionais para a solicitação de compra, incluindo o nome do produto a ser exibido ao usuário durante a compra.

Retornos

IAsyncOperation<StorePurchaseResult>

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StorePurchaseResult que fornece status e informações de erro sobre a compra.

Atributos
OverloadAttribute RemoteAsyncAttribute

Exceções

COMException

Se a propriedade ErrorCode da exceção tiver o valor 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), isso indicará que o método não foi chamado no thread da interface do usuário. Se você estiver chamando esse método em um aplicativo da área de trabalho que usa o Ponte de Desktop, isso também poderá indicar que você não configurou o <objeto xref:Windows.Services.Store.StoreContext?text=StoreContext> para especificar qual janela de aplicativo é a janela do proprietário para caixas de diálogo modais mostradas por esse método. Para obter mais informações, consulte este artigo.

Comentários

A ID da Loja para um aplicativo ou complemento está disponível no Partner Center e é retornada pela propriedade StoreId do StoreProduct que representa o aplicativo ou complemento.

Confira também

Aplica-se a

RequestPurchaseAsync(String)

Editar

Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio da Microsoft Store.

Importante

Esse método deve ser chamado no thread da interface do usuário.

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)

Parâmetros

storeId
String

Platform::String

winrt::hstring

A ID da Loja do aplicativo ou o complemento que você deseja comprar para o usuário atual.

Retornos

IAsyncOperation<StorePurchaseResult>

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StorePurchaseResult que fornece status e informações de erro sobre a compra.

Atributos
OverloadAttribute RemoteAsyncAttribute

Exceções

COMException

Se a propriedade ErrorCode da exceção tiver o valor 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), isso indicará que o método não foi chamado no thread da interface do usuário. Se você estiver chamando esse método em um aplicativo da área de trabalho que usa o Ponte de Desktop, isso também poderá indicar que você não configurou o <objeto xref:Windows.Services.Store.StoreContext?text=StoreContext> para especificar qual janela de aplicativo é a janela do proprietário para caixas de diálogo modais mostradas por esse método. Para obter mais informações, consulte este artigo.

Comentários

Para obter mais informações sobre como usar esse método, incluindo um exemplo de código, consulte Habilitar compras no aplicativo de aplicativos e complementos.

A ID da Loja para um aplicativo ou complemento está disponível no Partner Center e é retornada pela propriedade StoreId do StoreProduct que representa o aplicativo ou complemento.

Confira também

Aplica-se a