XStore
Material de referencia de las API de XStore. Proporciona funcionalidad relacionada con el comercio a un juego, incluidos detalles sobre el contenido disponible para comprar, la administración de paquetes de contenido descargable, la administración de licencias y las versiones de prueba del juego.Funciones
| Función | Descripción |
|---|---|
| XStoreAcquireLicenseForDurablesAsync | Adquiere una licencia para el elemento duradero especificado. |
| XStoreAcquireLicenseForDurablesResult | Recupera el resultado de una llamada a XStoreAcquireLicenseForDurablesAsync. |
| XStoreAcquireLicenseForPackageAsync | Adquiere una licencia para el DLC de un juego que el usuario tiene derecho a usar. |
| XStoreAcquireLicenseForPackageResult | Recupera los resultados de una llamada a XStoreAcquireLicenseForPackageAsync. |
| XStoreCanAcquireLicenseForPackageAsync | Recupera una licencia de vista previa para DLC. |
| XStoreCanAcquireLicenseForPackageResult | Obtiene los resultados de una llamada a XStoreCanAcquireLicenseForPackageAsync. |
| XStoreCanAcquireLicenseForStoreIdAsync | Recupera una licencia de vista previa para contenido. |
| XStoreCanAcquireLicenseForStoreIdResult | Obtiene los resultados de una llamada a XStoreCanAcquireLicenseForStoreIdAsync. |
| XStoreCloseContextHandle | Cierra el identificador de contexto de tienda especificado. |
| XStoreCloseLicenseHandle | Cierra el identificador de licencia de tienda especificado. |
| XStoreCloseProductsQueryHandle | Cierra el identificador de consulta de productos de tienda especificado. |
| XStoreCreateContext | Crea un contexto de tienda para el usuario especificado. |
| XStoreDownloadAndInstallPackagesAsync | Descarga e instala los paquetes de tienda especificados. |
| XStoreDownloadAndInstallPackagesResult | Obtiene los resultados de una llamada a XStoreDownloadAndInstallPackagesAsync. |
| XStoreDownloadAndInstallPackagesResultCount | Obtiene el número de elementos del resultado que devolverá XStoreDownloadAndInstallPackagesResult. |
| XStoreDownloadAndInstallPackageUpdatesAsync | Descarga e instala actualizaciones de los paquetes de tienda especificados. |
| XStoreDownloadAndInstallPackageUpdatesResult | Obtiene los resultados de una llamada a XStoreDownloadAndInstallPackageUpdatesAsync. |
| XStoreDownloadPackageUpdatesAsync | Descarga actualizaciones de los paquetes especificados. |
| XStoreDownloadPackageUpdatesResult | Obtiene los resultados de una llamada a XStoreDownloadPackageUpdatesAsync. |
| XStoreEnumerateProductsQuery | Enumera los resultados de una consulta de productos. |
| XStoreGameLicenseChangedCallback | Devolución de llamada definida por el juego para el evento de cambio de licencia del juego. |
| XStoreGetUserCollectionsIdAsync | Obtiene un identificador de colecciones del cliente. |
| XStoreGetUserCollectionsIdResult | Obtiene los resultados de una llamada a XStoreGetUserCollectionsIdAsync. |
| XStoreGetUserCollectionsIdResultSize | Obtiene el tamaño del identificador devuelto por XStoreGetUserCollectionsIdResult. |
| XStoreGetUserPurchaseIdAsync | Recupera un identificador de compra del cliente. |
| XStoreGetUserPurchaseIdResult | Obtiene el resultado de una llamada a XStoreGetUserPurchaseIdAsync. |
| XStoreGetUserPurchaseIdResultSize | Obtiene el tamaño del resultado devuelto por XStoreGetUserPurchaseIdResult. |
| XStoreIsLicenseValid | Comprueba si la licencia especificada es válida. |
| XStorePackageLicenseLostCallback | Devolución de llamada definida por el juego para el evento de pérdida de licencia. |
| XStoreProductQueryCallback | Devolución de llamada definida por el juego para una consulta de productos. |
| XStoreProductsQueryHasMorePages | Comprueba si hay más páginas de resultados para la consulta especificada. |
| XStoreProductsQueryNextPageAsync | Obtiene la página siguiente de resultados de la consulta. |
| XStoreProductsQueryNextPageResult | Obtiene la página siguiente de resultados de una consulta de productos. |
| XStoreQueryAddOnLicensesAsync | Enumera las licencias que se concedieron al usuario para elementos duraderos sin bits del juego que se está ejecutando actualmente. |
| XStoreQueryAddOnLicensesResult | Recupera el resultado de una llamada a XStoreQueryAddOnLicensesAsync. |
| XStoreQueryAddOnLicensesResultCount | Obtiene el número de licencias recuperadas por XStoreQueryAddonLicensesAsync. |
| XStoreQueryAssociatedProductsAsync | Obtiene información de listado de la Store de los productos que se pueden comprar desde el juego actual. |
| XStoreQueryAssociatedProductsForStoreIdAsync | Obtiene información de listado de la Store de los productos que se pueden comprar desde el producto especificado por el identificador de la Tienda. |
| XStoreQueryAssociatedProductsForStoreIdResult | Obtiene los resultados de una llamada a XStoreQueryAssociatedProductsForStoreIdAsync. |
| XStoreQueryAssociatedProductsResult | Obtiene los resultados de una llamada a XStoreQueryAssociatedProductsAsync. |
| XStoreQueryConsumableBalanceRemainingAsync | Obtiene el saldo de consumibles restante para el identificador de producto especificado. |
| XStoreQueryConsumableBalanceRemainingResult | Recupera los resultados de una llamada a XStoreQueryConsumableBalanceRemainingAsync. |
| XStoreQueryEntitledProductsAsync | Proporciona la información de producto de la Tienda de todos los complementos del juego actual que el usuario ha comprado. |
| XStoreQueryEntitledProductsResult | Obtiene los resultados de una llamada a XStoreQueryEntitledProductsAsync. |
| XStoreQueryGameAndDlcPackageUpdatesAsync | Obtiene actualizaciones del juego y opcionales para el paquete actual. |
| XStoreQueryGameAndDlcPackageUpdatesResult | Obtiene el resultado de una llamada a XStoreQueryGameAndDlcPackageUpdatesAsync. |
| XStoreQueryGameAndDlcPackageUpdatesResultCount | Obtiene el número de actualizaciones recuperadas por XStoreQueryGameAndDlcPackageUpdatesAsync. |
| XStoreQueryGameLicenseAsync | Recupera información sobre la licencia que se adquirió para permitir que el juego se inicie. |
| XStoreQueryGameLicenseResult | Obtiene los resultados de una llamada a XStoreQueryGameLicenseAsync. |
| XStoreQueryLicenseTokenAsync | Proporciona un token opaco al juego que realiza la llamada, que se puede pasar al servicio del juego para realizar llamadas B2B. |
| XStoreQueryLicenseTokenResult | Recupera los resultados de una llamada a XStoreQueryLicenseTokenAsync. |
| XStoreQueryLicenseTokenResultSize | Obtiene el tamaño del resultado que devolverá XstoreQueryLicenseTokenResult. |
| XStoreQueryPackageIdentifier | Recupera el identificador de paquete del identificador de tienda especificado. |
| XStoreQueryPackageUpdatesAsync | Recupera las actualizaciones disponibles para los paquetes especificados. |
| XStoreQueryPackageUpdatesResult | Obtiene el resultado de una llamada a XStoreQueryPackageUpdatesAsync. |
| XStoreQueryPackageUpdatesResultCount | Obtiene el número de actualizaciones recuperadas por XStoreQueryPackageUpdatesAsync. |
| XStoreQueryProductForCurrentGameAsync | Proporciona información de producto de la tienda para el juego que se está ejecutando actualmente, sus SKU y disponibilidades, y otros metadatos. |
| XStoreQueryProductForCurrentGameResult | Obtiene los resultados de una llamada a XStoreQueryProductForCurrentGameAsync. |
| XStoreQueryProductForPackageAsync | Recupera información de producto de la tienda para el paquete especificado. |
| XStoreQueryProductForPackageResult | Obtiene los resultados de una llamada a XStoreQueryProductForPackageAsync. |
| XStoreQueryProductsAsync | Devuelve información de listado de los productos especificados que están asociados al juego actual, independientemente de si los productos están disponibles actualmente para su compra dentro del juego actual. |
| XStoreQueryProductsResult | Obtiene los resultados de una llamada a XStoreQueryProductsAsync. |
| XStoreRegisterGameLicenseChanged | Registra una devolución de llamada para el evento de cambio de licencia del juego. |
| XStoreRegisterPackageLicenseLost | Registra una devolución de llamada para el evento de pérdida de licencia. |
| XStoreReportConsumableFulfillmentAsync | Consume la cantidad especificada de un consumible. |
| XStoreReportConsumableFulfillmentResult | Obtiene los resultados de una llamada a XStoreReportConsumableFulfillmentAsync. |
| XStoreShowAssociatedProductsUIAsync | Abre la aplicación Microsoft Store y muestra el conjunto de complementos disponibles asociados al juego. Esto se puede filtrar además por tipo de producto. |
| XStoreShowAssociatedProductsUIResult | Obtiene el resultado de una llamada a XStoreShowAssociatedProductsUIAsync. |
| XStoreShowGiftingUIAsync | Permite al juego solicitar la compra de un producto de tienda concreto como regalo para otro usuario. |
| XStoreShowGiftingUIResult | Obtiene los resultados de una llamada a XStoreShowGiftingUIAsync. |
| XStoreShowProductPageUIAsync | Abre la aplicación de la Tienda directamente en la página de detalles del ProductId especificado. |
| XStoreShowProductPageUIResult | Obtiene el resultado de una llamada a XStoreShowProductPageUIAsync. |
| XStoreShowPurchaseUIAsync | Permite al juego solicitar una compra de un producto de tienda concreto. |
| XStoreShowPurchaseUIResult | Obtiene los resultados de una llamada a XStoreShowPurchaseUIAsync. |
| XStoreShowRateAndReviewUIAsync | Muestra un cuadro de diálogo del sistema emergente para permitir que el usuario proporcione una reseña o decline hacerlo. |
| XStoreShowRateAndReviewUIResult | Obtiene el resultado de una llamada a XStoreShowRateAndReviewUIAsync. |
| XStoreShowRedeemTokenUIAsync | Desencadena el canje de un token especificado para el usuario actual. |
| XStoreShowRedeemTokenUIResult | Obtiene los resultados de una llamada a XStoreShowRedeemTokenUIAsync. |
| XStoreUnregisterGameLicenseChanged | Anula el registro de la devolución de llamada de cambio de licencia del juego especificada. |
| XStoreUnregisterPackageLicenseLost | Anula el registro de la devolución de llamada de pérdida de licencia de tienda especificada. |
Estructuras
| Estructura | Descripción |
|---|---|
| XStoreAddonLicense | Describe una licencia de complemento. |
| XStoreAvailability | Describe la disponibilidad de un producto. |
| XStoreCanAcquireLicenseResult | Obtiene el resultado de una llamada a XStoreCanAcquireLicenseForPackageAsync o XStoreCanAcquireLicenseForStoreIdAsync. |
| XStoreCollectionData | Describe una colección de la tienda. |
| XStoreConsumableResult | Representa la cantidad del consumible. |
| XStoreGameLicense | Describe una licencia de juego. |
| XStoreImage | Describe una imagen. |
| XStorePackageUpdate | Describe una actualización de paquete. |
| XStorePrice | Información de precios de la tienda. |
| XStoreProduct | Describe un producto de la tienda. |
| XStoreRateAndReviewResult | Los resultados de una llamada a XStoreShowRateAndReviewUIAsync. |
| XStoreSku | Describe una SKU de la tienda. |
| XStoreSubscriptionInfo | Contiene información sobre una suscripción. |
| XStoreVideo | Describe un vídeo de la tienda. |
Enumeraciones
| Enumeración | Descripción |
|---|---|
| XStoreCanLicenseStatus | Indica si un usuario podría obtener una licencia para un paquete. |
| XStoreDurationUnit | Unidades de un valor de duración. |
| XStoreProductKind | Indica el tipo de producto. |
Códigos de error
Las API de XStore pueden devolver los siguientes códigos de error. Para obtener una lista completa, consulte Códigos de error.| Código | Valor | Descripción |
|---|---|---|
| E_GAMESTORE_LICENSE_ACTION_NOT_APPLICABLE_TO_PRODUCT | 0x89245300 | El juego solicitó una licencia para un producto para el que no se puede obtener licencia. |
| E_GAMESTORE_NETWORK_ERROR | 0x89245301 | El juego no pudo comunicarse con la red de la tienda. |
| E_GAMESTORE_SERVER_ERROR | 0x89245302 | El juego recibió una respuesta incorrecta del servidor de la tienda. |
| E_GAMESTORE_INSUFFICIENT_QUANTITY | 0x89245303 | El usuario no tiene una cantidad suficiente de este consumible para usar la cantidad solicitada. |
| E_GAMESTORE_ALREADY_PURCHASED | 0x89245304 | El usuario ya posee este producto. |
| E_GAMESTORE_LICENSE_ACTION_THROTTLED | 0x89245305 | El juego consultó excesivamente una licencia para el producto y ahora está limitado. El límite es de 30 intentos de licencia en 10 minutos para el mismo producto. |
Documentación conceptual
- Información general sobre comercio
- Información general sobre XStore
- Operaciones básicas de la tienda con XStore
Consulte también
Referencia de API del sistemaReferencia de API de XPackage
Información general sobre comercio