> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XStore > XStore # XStore XStore API 的参考资料。 为游戏提供商业相关功能，包括有关可购买内容的详细信息、可下载内容包管理、许可证管理和游戏试用。 ## 函数 | 函数 | 说明 | | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync) | 获取指定耐用型产品的许可证。 | | [XStoreAcquireLicenseForDurablesResult](/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult) | 检索对 [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/functions/xstoreacquirelicensefordurablesasync) 调用的结果。 | | [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) | 获取用户有权使用的游戏 DLC 许可证。 | | [XStoreAcquireLicenseForPackageResult](/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult) | 检索对 [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) 调用的结果。 | | [XStoreCanAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforpackageasync) | 检索 DLC 的预览许可证。 | | [XStoreCanAcquireLicenseForPackageResult](/reference/system/xstore/functions/xstorecanacquirelicenseforpackageresult) | 获取对 [XStoreCanAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforpackageasync) 调用的结果。 | | [XStoreCanAcquireLicenseForStoreIdAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforstoreidasync) | 检索内容的预览许可证。 | | [XStoreCanAcquireLicenseForStoreIdResult](/reference/system/xstore/functions/xstorecanacquirelicenseforstoreidresult) | 获取对 [XStoreCanAcquireLicenseForStoreIdAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforstoreidasync) 调用的结果。 | | [XStoreCloseContextHandle](/reference/system/xstore/functions/xstoreclosecontexthandle) | 关闭指定的商店上下文句柄。 | | [XStoreCloseLicenseHandle](/reference/system/xstore/functions/xstorecloselicensehandle) | 关闭指定的商店许可证句柄。 | | [XStoreCloseProductsQueryHandle](/reference/system/xstore/functions/xstorecloseproductsqueryhandle) | 关闭指定的商店产品查询句柄。 | | [XStoreCreateContext](/reference/system/xstore/functions/xstorecreatecontext) | 为指定用户创建商店上下文。 | | [XStoreDownloadAndInstallPackagesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackagesasync) | 下载并安装指定的商店包。 | | [XStoreDownloadAndInstallPackagesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult) | 获取对 [XStoreDownloadAndInstallPackagesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackagesasync) 调用的结果。 | | [XStoreDownloadAndInstallPackagesResultCount](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresultcount) | 获取将由 [XStoreDownloadAndInstallPackagesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult) 返回的结果中的项目数。 | | [XStoreDownloadAndInstallPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync) | 下载并安装指定商店包的更新。 | | [XStoreDownloadAndInstallPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult) | 获取对 [XStoreDownloadAndInstallPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync) 调用的结果。 | | [XStoreDownloadPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadpackageupdatesasync) | 下载指定包的更新。 | | [XStoreDownloadPackageUpdatesResult](/reference/system/xstore/functions/xstoredownloadpackageupdatesresult) | 获取对 [XStoreDownloadPackageUpdatesAsync](/reference/system/xstore/functions/xstoredownloadpackageupdatesasync) 调用的结果。 | | [XStoreEnumerateProductsQuery](/reference/system/xstore/functions/xstoreenumerateproductsquery) | 枚举产品查询的结果。 | | [XStoreGameLicenseChangedCallback](/reference/system/xstore/functions/xstoregamelicensechangedcallback) | 用于游戏许可证更改事件的游戏定义回调。 | | [XStoreGetUserCollectionsIdAsync](/reference/system/xstore/functions/xstoregetusercollectionsidasync) | 获取客户集合 ID。 | | [XStoreGetUserCollectionsIdResult](/reference/system/xstore/functions/xstoregetusercollectionsidresult) | 获取对 [XStoreGetUserCollectionsIdAsync](/reference/system/xstore/functions/xstoregetusercollectionsidasync) 调用的结果。 | | [XStoreGetUserCollectionsIdResultSize](/reference/system/xstore/functions/xstoregetusercollectionsidresultsize) | 获取 [XStoreGetUserCollectionsIdResult](/reference/system/xstore/functions/xstoregetusercollectionsidresult) 返回的 ID 的大小。 | | [XStoreGetUserPurchaseIdAsync](/reference/system/xstore/functions/xstoregetuserpurchaseidasync) | 检索客户购买 ID。 | | [XStoreGetUserPurchaseIdResult](/reference/system/xstore/functions/xstoregetuserpurchaseidresult) | 获取对 [XStoreGetUserPurchaseIdAsync](/reference/system/xstore/functions/xstoregetuserpurchaseidasync) 调用的结果。 | | [XStoreGetUserPurchaseIdResultSize](/reference/system/xstore/functions/xstoregetuserpurchaseidresultsize) | 获取 [XStoreGetUserPurchaseIdResult](/reference/system/xstore/functions/xstoregetuserpurchaseidresult) 返回的结果的大小。 | | [XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid) | 检查指定的许可证是否有效。 | | [XStorePackageLicenseLostCallback](/reference/system/xstore/functions/xstorepackagelicenselostcallback) | 用于许可证丢失事件的游戏定义回调。 | | [XStoreProductQueryCallback](/reference/system/xstore/functions/xstoreproductquerycallback) | 用于产品查询的游戏定义回调。 | | [XStoreProductsQueryHasMorePages](/reference/system/xstore/functions/xstoreproductsqueryhasmorepages) | 检查指定查询是否有更多的结果页。 | | [XStoreProductsQueryNextPageAsync](/reference/system/xstore/functions/xstoreproductsquerynextpageasync) | 获取查询结果的下一页。 | | [XStoreProductsQueryNextPageResult](/reference/system/xstore/functions/xstoreproductsquerynextpageresult) | 获取产品查询结果的下一页。 | | [XStoreQueryAddOnLicensesAsync](/reference/system/xstore/functions/xstorequeryaddonlicensesasync) | 枚举授予用户的没有当前正在运行的游戏部分的耐用型产品的许可证。 | | [XStoreQueryAddOnLicensesResult](/reference/system/xstore/functions/xstorequeryaddonlicensesresult) | 检索对 XStoreQueryAddOnLicensesAsync 调用的结果。 | | [XStoreQueryAddOnLicensesResultCount](/reference/system/xstore/functions/xstorequeryaddonlicensesresultcount) | 获取由 [XStoreQueryAddonLicensesAsync](/reference/system/xstore/functions/xstorequeryaddonlicensesasync) 检索的许可证数量。 | | [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync) | 获取可在当前游戏中购买的产品的商店列表信息。 | | [XStoreQueryAssociatedProductsForStoreIdAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsforstoreidasync) | 获取可从由商店 ID 指定的产品中购买的产品的商店列表信息。 | | [XStoreQueryAssociatedProductsForStoreIdResult](/reference/system/xstore/functions/xstorequeryassociatedproductsforstoreidresult) | 获取对 [XStoreQueryAssociatedProductsForStoreIdAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsforstoreidasync) 调用的结果。 | | [XStoreQueryAssociatedProductsResult](/reference/system/xstore/functions/xstorequeryassociatedproductsresult) | 获取对 [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/functions/xstorequeryassociatedproductsasync) 调用的结果。 | | [XStoreQueryConsumableBalanceRemainingAsync](/reference/system/xstore/functions/xstorequeryconsumablebalanceremainingasync) | 获取指定产品 ID 的消耗品剩余余额。 | | [XStoreQueryConsumableBalanceRemainingResult](/reference/system/xstore/functions/xstorequeryconsumablebalanceremainingresult) | 检索对 [XStoreQueryConsumableBalanceRemainingAsync](/reference/system/xstore/functions/xstorequeryconsumablebalanceremainingasync) 调用的结果。 | | [XStoreQueryEntitledProductsAsync](/reference/system/xstore/functions/xstorequeryentitledproductsasync) | 提供用户已购买的当前游戏所有加载项的商店产品信息。 | | [XStoreQueryEntitledProductsResult](/reference/system/xstore/functions/xstorequeryentitledproductsresult) | 获取对 [XStoreQueryEntitledProductsAsync](/reference/system/xstore/functions/xstorequeryentitledproductsasync) 调用的结果。 | | [XStoreQueryGameAndDlcPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync) | 获取当前包的游戏和可选更新。 | | [XStoreQueryGameAndDlcPackageUpdatesResult](/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesresult) | 获取对 [XStoreQueryGameAndDlcPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync) 调用的结果。 | | [XStoreQueryGameAndDlcPackageUpdatesResultCount](/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesresultcount) | 获取由 [XStoreQueryGameAndDlcPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync) 检索的更新数量。 | | [XStoreQueryGameLicenseAsync](/reference/system/xstore/functions/xstorequerygamelicenseasync) | 检索有关为允许游戏启动而获取的许可证的信息。 | | [XStoreQueryGameLicenseResult](/reference/system/xstore/functions/xstorequerygamelicenseresult) | 获取对 [XStoreQueryGameLicenseAsync](/reference/system/xstore/functions/xstorequerygamelicenseasync) 调用的结果。 | | [XStoreQueryLicenseTokenAsync](/reference/system/xstore/functions/xstorequerylicensetokenasync) | 向调用游戏提供不透明令牌，该令牌可传递给游戏服务以进行 B2B 调用。 | | [XStoreQueryLicenseTokenResult](/reference/system/xstore/functions/xstorequerylicensetokenresult) | 检索对 [XStoreQueryLicenseTokenAsync](/reference/system/xstore/functions/xstorequerylicensetokenasync) 调用的结果。 | | [XStoreQueryLicenseTokenResultSize](/reference/system/xstore/functions/xstorequerylicensetokenresultsize) | 获取由 [XstoreQueryLicenseTokenResult](/reference/system/xstore/functions/xstorequerylicensetokenresult) 返回的结果的大小。 | | [XStoreQueryPackageIdentifier](/reference/system/xstore/functions/xstorequerypackageidentifier) | 检索指定商店 ID 的包标识符。 | | [XStoreQueryPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerypackageupdatesasync) | 检索指定包的可用更新。 | | [XStoreQueryPackageUpdatesResult](/reference/system/xstore/functions/xstorequerypackageupdatesresult) | 获取对 [XStoreQueryPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerypackageupdatesasync) 调用的结果。 | | [XStoreQueryPackageUpdatesResultCount](/reference/system/xstore/functions/xstorequerypackageupdatesresultcount) | 获取由 [XStoreQueryPackageUpdatesAsync](/reference/system/xstore/functions/xstorequerypackageupdatesasync) 检索的更新数量。 | | [XStoreQueryProductForCurrentGameAsync](/reference/system/xstore/functions/xstorequeryproductforcurrentgameasync) | 提供当前正在运行的游戏的商店产品信息、其 sku 和可用性以及其他元数据。 | | [XStoreQueryProductForCurrentGameResult](/reference/system/xstore/functions/xstorequeryproductforcurrentgameresult) | 获取对 [XStoreQueryProductForCurrentGameAsync](/reference/system/xstore/functions/xstorequeryproductforcurrentgameasync) 调用的结果。 | | [XStoreQueryProductForPackageAsync](/reference/system/xstore/functions/xstorequeryproductforpackageasync) | 检索指定包的商店产品信息。 | | [XStoreQueryProductForPackageResult](/reference/system/xstore/functions/xstorequeryproductforpackageresult) | 获取对 [XStoreQueryProductForPackageAsync](/reference/system/xstore/functions/xstorequeryproductforpackageasync) 调用的结果。 | | [XStoreQueryProductsAsync](/reference/system/xstore/functions/xstorequeryproductsasync) | 返回与当前游戏关联的指定产品的列表信息，无论这些产品当前是否可在当前游戏中购买。 | | [XStoreQueryProductsResult](/reference/system/xstore/functions/xstorequeryproductsresult) | 获取对 [XStoreQueryProductsAsync](/reference/system/xstore/functions/xstorequeryproductsasync) 调用的结果。 | | [XStoreRegisterGameLicenseChanged](/reference/system/xstore/functions/xstoreregistergamelicensechanged) | 为游戏许可证更改事件注册回调。 | | [XStoreRegisterPackageLicenseLost](/reference/system/xstore/functions/xstoreregisterpackagelicenselost) | 为许可证丢失事件注册回调。 | | [XStoreReportConsumableFulfillmentAsync](/reference/system/xstore/functions/xstorereportconsumablefulfillmentasync) | 消耗指定数量的消耗品。 | | [XStoreReportConsumableFulfillmentResult](/reference/system/xstore/functions/xstorereportconsumablefulfillmentresult) | 获取对 [XStoreReportConsumableFulfillmentAsync](/reference/system/xstore/functions/xstorereportconsumablefulfillmentasync) 调用的结果。 | | [XStoreShowAssociatedProductsUIAsync](/reference/system/xstore/functions/xstoreshowassociatedproductsuiasync) | 这将打开 Microsoft Store 应用，并显示与游戏关联的可用加载项集合。可以按产品类型进一步筛选。 | | [XStoreShowAssociatedProductsUIResult](/reference/system/xstore/functions/xstoreshowassociatedproductsuiresult) | 获取对 [XStoreShowAssociatedProductsUIAsync](/reference/system/xstore/functions/xstoreshowassociatedproductsuiasync) 调用的结果。 | | [XStoreShowGiftingUIAsync](/reference/system/xstore/functions/xstoreshowgiftinguiasync) | 允许游戏请求将特定商店产品作为礼物为另一用户购买。 | | [XStoreShowGiftingUIResult](/reference/system/xstore/functions/xstoreshowgiftinguiresult) | 获取对 [XStoreShowGiftingUIAsync](/reference/system/xstore/functions/xstoreshowgiftinguiasync) 调用的结果。 | | [XStoreShowProductPageUIAsync](/reference/system/xstore/functions/xstoreshowproductpageuiasync) | 直接打开商店应用到指定 ProductId 的详细信息页面。 | | [XStoreShowProductPageUIResult](/reference/system/xstore/functions/xstoreshowproductpageuiresult) | 获取对 [XStoreShowProductPageUIAsync](/reference/system/xstore/functions/xstoreshowproductpageuiasync) 调用的结果。 | | [XStoreShowPurchaseUIAsync](/reference/system/xstore/functions/xstoreshowpurchaseuiasync) | 允许游戏请求购买特定的商店产品。 | | [XStoreShowPurchaseUIResult](/reference/system/xstore/functions/xstoreshowpurchaseuiresult) | 获取对 [XStoreShowPurchaseUIAsync](/reference/system/xstore/functions/xstoreshowpurchaseuiasync) 调用的结果。 | | [XStoreShowRateAndReviewUIAsync](/reference/system/xstore/functions/xstoreshowrateandreviewuiasync) | 显示一个系统对话框弹窗，允许用户提供评论或拒绝提供评论。 | | [XStoreShowRateAndReviewUIResult](/reference/system/xstore/functions/xstoreshowrateandreviewuiresult) | 获取对 [XStoreShowRateAndReviewUIAsync](/reference/system/xstore/functions/xstoreshowrateandreviewuiasync) 调用的结果。 | | [XStoreShowRedeemTokenUIAsync](/reference/system/xstore/functions/xstoreshowredeemtokenuiasync) | 为当前用户触发指定令牌的令牌兑换。 | | [XStoreShowRedeemTokenUIResult](/reference/system/xstore/functions/xstoreshowredeemtokenuiresult) | 获取对 [XStoreShowRedeemTokenUIAsync](/reference/system/xstore/functions/xstoreshowredeemtokenuiasync) 调用的结果。 | | [XStoreUnregisterGameLicenseChanged](/reference/system/xstore/functions/xstoreunregistergamelicensechanged) | 取消注册指定的游戏许可证更改回调。 | | [XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost) | 取消注册指定的商店许可证丢失回调。 | ## 结构 | 结构 | 说明 | | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [XStoreAddonLicense](/reference/system/xstore/structs/xstoreaddonlicense) | 描述加载项许可证。 | | [XStoreAvailability](/reference/system/xstore/structs/xstoreavailability) | 描述产品的可用性。 | | [XStoreCanAcquireLicenseResult](/reference/system/xstore/structs/xstorecanacquirelicenseresult) | 获取对 [XStoreCanAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforpackageasync) 或 [XStoreCanAcquireLicenseForStoreIdAsync](/reference/system/xstore/functions/xstorecanacquirelicenseforstoreidasync) 调用的结果。 | | [XStoreCollectionData](/reference/system/xstore/structs/xstorecollectiondata) | 描述商店集合。 | | [XStoreConsumableResult](/reference/system/xstore/structs/xstoreconsumableresult) | 表示消耗品的数量。 | | [XStoreGameLicense](/reference/system/xstore/structs/xstoregamelicense) | 描述游戏许可证。 | | [XStoreImage](/reference/system/xstore/structs/xstoreimage) | 描述图像。 | | [XStorePackageUpdate](/reference/system/xstore/structs/xstorepackageupdate) | 描述包更新。 | | [XStorePrice](/reference/system/xstore/structs/xstoreprice) | 商店价格信息。 | | [XStoreProduct](/reference/system/xstore/structs/xstoreproduct) | 描述商店产品。 | | [XStoreRateAndReviewResult](/reference/system/xstore/structs/xstorerateandreviewresult) | 对 [XStoreShowRateAndReviewUIAsync](/reference/system/xstore/functions/xstoreshowrateandreviewuiasync) 调用的结果。 | | [XStoreSku](/reference/system/xstore/structs/xstoresku) | 描述商店 SKU。 | | [XStoreSubscriptionInfo](/reference/system/xstore/structs/xstoresubscriptioninfo) | 包含订阅信息。 | | [XStoreVideo](/reference/system/xstore/structs/xstorevideo) | 描述商店视频。 | ## 枚举 | 枚举 | 说明 | | ------------------------------------------------------------------------------- | ------------ | | [XStoreCanLicenseStatus](/reference/system/xstore/enums/xstorecanlicensestatus) | 指示用户是否能够许可包。 | | [XStoreDurationUnit](/reference/system/xstore/enums/xstoredurationunit) | 持续时间值的单位。 | | [XStoreProductKind](/reference/system/xstore/enums/xstoreproductkind) | 指示产品类型。 | ## 错误代码 以下错误代码可能由 XStore API 返回。有关完整列表，请参阅[错误代码](/reference/errorcodes)。 | 代码 | 值 | 说明 | | ----------------------------------------------------------- | ---------- | ---------------------------------------------- | | E\_GAMESTORE\_LICENSE\_ACTION\_NOT\_APPLICABLE\_TO\_PRODUCT | 0x89245300 | 游戏请求了无法许可的产品的许可证。 | | E\_GAMESTORE\_NETWORK\_ERROR | 0x89245301 | 游戏无法与商店网络通信。 | | E\_GAMESTORE\_SERVER\_ERROR | 0x89245302 | 游戏收到了来自商店服务器的错误响应。 | | E\_GAMESTORE\_INSUFFICIENT\_QUANTITY | 0x89245303 | 用户没有足够数量的该消耗品来使用请求的数量。 | | E\_GAMESTORE\_ALREADY\_PURCHASED | 0x89245304 | 用户已拥有此产品。 | | E\_GAMESTORE\_LICENSE\_ACTION\_THROTTLED | 0x89245305 | 游戏过度查询该产品的许可证，现已被限流。同一产品在 10 分钟内的限制为 30 次授权尝试。 | ## 概念文档 * [商业概述](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/commerce-nav) * [XStore 概述](/publishing/xstore-commerce/xstore-overview) * [XStore 基本商店操作](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-basic-store-operations) ## 另请参阅 [System API 参考](/reference/system/gc-reference-system-toc)\ [XPackage API 参考](/reference/system/xpackage/xpackage_members)\ [商业概述](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/commerce-nav) ## Related topics - [XStore 商务概述](/zh-CN/publishing/xstore-commerce/xstore-commerce-overview.md) - [排查 XStore 开发问题](/zh-CN/publishing/xstore-commerce/xstore-troubleshooting.md) - [XStorePrice](/zh-CN/reference/system/xstore/structs/xstoreprice.md) - [XStoreImage](/zh-CN/reference/system/xstore/structs/xstoreimage.md) - [XStoreSku](/zh-CN/reference/system/xstore/structs/xstoresku.md)