Skip to main content

XStoreShowGiftingUIAsync

Inicia la superposición de interfaz de usuario para comprar el producto especificado como regalo para otro usuario. Se pedirá al usuario actual que escriba información sobre el destinatario del regalo y se le guiará a través del flujo de compra.

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á como regalo. Nota: este producto debe estar configurado para admitir compras de regalos. name   _In_opt_z_
Tipo: char*
Nombre del producto que se comprará como regalo. extendedJsonData   _In_opt_z_
Tipo: char*
Un blob JSON que se pasa al flujo de compra de regalo. 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

El producto que se comprará como regalo debe estar configurado para admitir compras de regalos. Para recuperar la lista de productos que admiten regalos, llame a XStoreQueryProductsAsync con el parámetro actionFilters establecido en "Gift". Para recuperar el resultado de esta función, llame a XStoreShowGiftingUIResult después de llamar a esta función. Solo se debe llamar a esta función cuando el usuario haya elegido comprar algo como regalo, 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 de regalo 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

Consulte también

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