StoreContext.RequestPurchaseAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| 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 do Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica em um catálogo grande de produtos que são representados por uma única listagem no 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. Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. |
| 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 do Microsoft Store. Importante Esse método deve ser chamado no thread da interface do usuário. Importante Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados. |
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 do Microsoft Store. Esse método fornece a opção de especificar detalhes adicionais para uma oferta específica em um catálogo grande de produtos que são representados por uma única listagem no 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.
Importante
Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados.
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
Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StorePurchaseResult que fornece informações de status e erro sobre a compra.
- Atributos
Exceções
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 a Ponte da Área de Trabalho, isso também pode indicar que você não configurou o <xref href="Windows. Services.Store.StoreContext?text=StoreContext" /> objeto para especificar qual janela do aplicativo é a janela de 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)
Solicita a compra para o aplicativo ou complemento especificado e exibe a interface do usuário usada para concluir a transação por meio do Microsoft Store.
Importante
Esse método deve ser chamado no thread da interface do usuário.
Importante
Não há suporte para a funcionalidade de compra no aplicativo em aplicativos com privilégios elevados.
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
Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StorePurchaseResult que fornece informações de status e erro sobre a compra.
- Atributos
Exceções
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 a Ponte da Área de Trabalho, isso também pode indicar que você não configurou o <xref href="Windows. Services.Store.StoreContext?text=StoreContext" /> objeto para especificar qual janela do aplicativo é a janela de 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
- RequestPurchaseAsync(String, StorePurchaseProperties)
- Habilitar compras no aplicativo e aquisição de complementos