Skip to main content

XStoreShowPurchaseUIAsync

Inicia a sobreposição da interface do usuário de compra para o produto especificado.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. storeId   _In_z_
Tipo: char*
ID do produto a ser comprado. name   _In_opt_z_
Tipo: char*
Nome do produto a ser comprado. extendedJsonData   _In_opt_z_
Tipo: char*
Um blob JSON que é entregue ao fluxo de compra. Permite a inserção de IDs de campanha personalizadas, para que você possa acompanhar como a compra foi iniciada. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte XAsyncBlock para obter mais informações.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

![NOTE] Esta operação não dispara o download nem a instalação dos itens após uma compra esperada. Se você quiser baixar e instalar esse conteúdo, é recomendável chamar XStoreDownloadAndInstallPackagesAsync após uma compra bem-sucedida. Nenhum aviso adicional será exibido ao usuário.
![NOTE] No PC, a caixa de diálogo de confirmação de compra exibida após uma compra bem-sucedida terá um botão de fechar [X] na parte superior. Selecioná-lo em vez de Ok fará com que E_ABORT seja retornado para XStoreShowPurchaseUIResult, o que pode não ser desejado. Esse é o comportamento padrão do Windows quando qualquer caixa de diálogo é fechada dessa forma.
Para recuperar o resultado desta função, chame XStoreShowPurchaseUIResult após chamar esta função. Esta função só deve ser chamada quando o usuário tiver optado por comprar algo e fará com que o sistema apresente uma caixa de diálogo de compra modal que lida com as informações de pagamento e a confirmação do usuário fora do processo. O trecho de código a seguir mostra um exemplo de solicitação de compra de um produto específico da loja.

Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XStore
XStoreShowPurchaseUIResult
Last modified on October 6, 2026