Skip to main content

XStoreShowGiftingUIAsync

Inicia a sobreposição da interface do usuário para comprar o produto especificado como presente para outro usuário. O usuário atual será solicitado a inserir informações sobre o destinatário do presente e será guiado pelo fluxo de compra.

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 como presente. Observação: esse produto deve estar configurado para dar suporte a compras para presente. name   _In_opt_z_
Tipo: char*
Nome do produto a ser comprado como presente. extendedJsonData   _In_opt_z_
Tipo: char*
Um blob JSON que é entregue ao fluxo de compra de presente. Permite a inserção de IDs de campanha personalizadas, para que você possa rastrear 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. Confira XAsyncBlock para obter mais informações.

Valor retornado

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

Comentários

O produto a ser comprado como presente deve estar configurado para dar suporte a compras para presente. Para recuperar a lista de produtos que dão suporte a presentes, chame XStoreQueryProductsAsync com o parâmetro actionFilters definido como "Gift". Para recuperar o resultado desta função, chame XStoreShowGiftingUIResult após chamar esta função. Esta função só deve ser chamada quando o usuário tiver optado por comprar algo como presente, e fará com que o sistema apresente uma caixa de diálogo modal de compra que lida com as informações de pagamento e a confirmação do usuário fora do processo. O snippet de código a seguir mostra um exemplo de solicitação de compra de presente para um produto específico da loja.

Requisitos

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

Confira também

XStore
XStoreShowGiftingUIResult
Last modified on October 6, 2026