Skip to main content

XStoreShowPurchaseUIAsync

Inicia la superposición de interfaz de usuario de compra para el producto especificado.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. storeId   _In_z_
Tipo: char*
Identificador del producto que se comprará. name   _In_opt_z_
Tipo: char*
Nombre del producto que se comprará. extendedJsonData   _In_opt_z_
Tipo: char*
Un blob JSON que se pasa al flujo de compra. Permite insertar identificadores de campaña personalizados, para que pueda hacer un seguimiento de cómo se inició la compra. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Consulte XAsyncBlock para obtener más información.

Valor devuelto

Tipo: HRESULT Código HRESULT de éxito o de error.

Comentarios

![NOTE] Esta operación no desencadena la descarga ni la instalación de los elementos después de una compra prevista. Si quiere descargar e instalar este contenido, se recomienda llamar a XStoreDownloadAndInstallPackagesAsync después de una compra correcta. No se mostrará ningún aviso adicional al usuario.
![NOTE] En PC, el cuadro de diálogo de confirmación de compra que se muestra después de una compra correcta tendrá un botón de cierre [X] en la parte superior. Si se selecciona este en lugar de Aceptar, se devolverá E_ABORT a XStoreShowPurchaseUIResult, lo que puede no ser lo deseado. Este es el comportamiento estándar de Windows cuando se cierra cualquier cuadro de diálogo de esta manera.
Para recuperar el resultado de esta función, llame a XStoreShowPurchaseUIResult después de llamar a esta función. Solo se debe llamar a esta función cuando el usuario haya elegido comprar algo, y hará que el sistema presente un cuadro de diálogo de compra modal que controla la información de pago y la confirmación del usuario fuera del proceso. El siguiente fragmento de código muestra un ejemplo de solicitud de una compra para un producto concreto de la tienda.

Requisitos

Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XStore
XStoreShowPurchaseUIResult
Última modificación el 28 de agosto de 2026