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ámetroactionFilters 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 SeriesConsulte también
XStoreXStoreShowGiftingUIResult
