XStore

XStore API 的参考资料。为游戏提供商业相关功能，包括有关可购买内容的详细信息、可下载内容包管理、许可证管理和游戏试用。

函数

函数	说明
XStoreAcquireLicenseForDurablesAsync	获取指定耐用型产品的许可证。
XStoreAcquireLicenseForDurablesResult	检索对 XStoreAcquireLicenseForDurablesAsync 调用的结果。
XStoreAcquireLicenseForPackageAsync	获取用户有权使用的游戏 DLC 许可证。
XStoreAcquireLicenseForPackageResult	检索对 XStoreAcquireLicenseForPackageAsync 调用的结果。
XStoreCanAcquireLicenseForPackageAsync	检索 DLC 的预览许可证。
XStoreCanAcquireLicenseForPackageResult	获取对 XStoreCanAcquireLicenseForPackageAsync 调用的结果。
XStoreCanAcquireLicenseForStoreIdAsync	检索内容的预览许可证。
XStoreCanAcquireLicenseForStoreIdResult	获取对 XStoreCanAcquireLicenseForStoreIdAsync 调用的结果。
XStoreCloseContextHandle	关闭指定的商店上下文句柄。
XStoreCloseLicenseHandle	关闭指定的商店许可证句柄。
XStoreCloseProductsQueryHandle	关闭指定的商店产品查询句柄。
XStoreCreateContext	为指定用户创建商店上下文。
XStoreDownloadAndInstallPackagesAsync	下载并安装指定的商店包。
XStoreDownloadAndInstallPackagesResult	获取对 XStoreDownloadAndInstallPackagesAsync 调用的结果。
XStoreDownloadAndInstallPackagesResultCount	获取将由 XStoreDownloadAndInstallPackagesResult 返回的结果中的项目数。
XStoreDownloadAndInstallPackageUpdatesAsync	下载并安装指定商店包的更新。
XStoreDownloadAndInstallPackageUpdatesResult	获取对 XStoreDownloadAndInstallPackageUpdatesAsync 调用的结果。
XStoreDownloadPackageUpdatesAsync	下载指定包的更新。
XStoreDownloadPackageUpdatesResult	获取对 XStoreDownloadPackageUpdatesAsync 调用的结果。
XStoreEnumerateProductsQuery	枚举产品查询的结果。
XStoreGameLicenseChangedCallback	用于游戏许可证更改事件的游戏定义回调。
XStoreGetUserCollectionsIdAsync	获取客户集合 ID。
XStoreGetUserCollectionsIdResult	获取对 XStoreGetUserCollectionsIdAsync 调用的结果。
XStoreGetUserCollectionsIdResultSize	获取 XStoreGetUserCollectionsIdResult 返回的 ID 的大小。
XStoreGetUserPurchaseIdAsync	检索客户购买 ID。
XStoreGetUserPurchaseIdResult	获取对 XStoreGetUserPurchaseIdAsync 调用的结果。
XStoreGetUserPurchaseIdResultSize	获取 XStoreGetUserPurchaseIdResult 返回的结果的大小。
XStoreIsLicenseValid	检查指定的许可证是否有效。
XStorePackageLicenseLostCallback	用于许可证丢失事件的游戏定义回调。
XStoreProductQueryCallback	用于产品查询的游戏定义回调。
XStoreProductsQueryHasMorePages	检查指定查询是否有更多的结果页。
XStoreProductsQueryNextPageAsync	获取查询结果的下一页。
XStoreProductsQueryNextPageResult	获取产品查询结果的下一页。
XStoreQueryAddOnLicensesAsync	枚举授予用户的没有当前正在运行的游戏部分的耐用型产品的许可证。
XStoreQueryAddOnLicensesResult	检索对 XStoreQueryAddOnLicensesAsync 调用的结果。
XStoreQueryAddOnLicensesResultCount	获取由 XStoreQueryAddonLicensesAsync 检索的许可证数量。
XStoreQueryAssociatedProductsAsync	获取可在当前游戏中购买的产品的商店列表信息。
XStoreQueryAssociatedProductsForStoreIdAsync	获取可从由商店 ID 指定的产品中购买的产品的商店列表信息。
XStoreQueryAssociatedProductsForStoreIdResult	获取对 XStoreQueryAssociatedProductsForStoreIdAsync 调用的结果。
XStoreQueryAssociatedProductsResult	获取对 XStoreQueryAssociatedProductsAsync 调用的结果。
XStoreQueryConsumableBalanceRemainingAsync	获取指定产品 ID 的消耗品剩余余额。
XStoreQueryConsumableBalanceRemainingResult	检索对 XStoreQueryConsumableBalanceRemainingAsync 调用的结果。
XStoreQueryEntitledProductsAsync	提供用户已购买的当前游戏所有加载项的商店产品信息。
XStoreQueryEntitledProductsResult	获取对 XStoreQueryEntitledProductsAsync 调用的结果。
XStoreQueryGameAndDlcPackageUpdatesAsync	获取当前包的游戏和可选更新。
XStoreQueryGameAndDlcPackageUpdatesResult	获取对 XStoreQueryGameAndDlcPackageUpdatesAsync 调用的结果。
XStoreQueryGameAndDlcPackageUpdatesResultCount	获取由 XStoreQueryGameAndDlcPackageUpdatesAsync 检索的更新数量。
XStoreQueryGameLicenseAsync	检索有关为允许游戏启动而获取的许可证的信息。
XStoreQueryGameLicenseResult	获取对 XStoreQueryGameLicenseAsync 调用的结果。
XStoreQueryLicenseTokenAsync	向调用游戏提供不透明令牌，该令牌可传递给游戏服务以进行 B2B 调用。
XStoreQueryLicenseTokenResult	检索对 XStoreQueryLicenseTokenAsync 调用的结果。
XStoreQueryLicenseTokenResultSize	获取由 XstoreQueryLicenseTokenResult 返回的结果的大小。
XStoreQueryPackageIdentifier	检索指定商店 ID 的包标识符。
XStoreQueryPackageUpdatesAsync	检索指定包的可用更新。
XStoreQueryPackageUpdatesResult	获取对 XStoreQueryPackageUpdatesAsync 调用的结果。
XStoreQueryPackageUpdatesResultCount	获取由 XStoreQueryPackageUpdatesAsync 检索的更新数量。
XStoreQueryProductForCurrentGameAsync	提供当前正在运行的游戏的商店产品信息、其 sku 和可用性以及其他元数据。
XStoreQueryProductForCurrentGameResult	获取对 XStoreQueryProductForCurrentGameAsync 调用的结果。
XStoreQueryProductForPackageAsync	检索指定包的商店产品信息。
XStoreQueryProductForPackageResult	获取对 XStoreQueryProductForPackageAsync 调用的结果。
XStoreQueryProductsAsync	返回与当前游戏关联的指定产品的列表信息，无论这些产品当前是否可在当前游戏中购买。
XStoreQueryProductsResult	获取对 XStoreQueryProductsAsync 调用的结果。
XStoreRegisterGameLicenseChanged	为游戏许可证更改事件注册回调。
XStoreRegisterPackageLicenseLost	为许可证丢失事件注册回调。
XStoreReportConsumableFulfillmentAsync	消耗指定数量的消耗品。
XStoreReportConsumableFulfillmentResult	获取对 XStoreReportConsumableFulfillmentAsync 调用的结果。
XStoreShowAssociatedProductsUIAsync	这将打开 Microsoft Store 应用，并显示与游戏关联的可用加载项集合。可以按产品类型进一步筛选。
XStoreShowAssociatedProductsUIResult	获取对 XStoreShowAssociatedProductsUIAsync 调用的结果。
XStoreShowGiftingUIAsync	允许游戏请求将特定商店产品作为礼物为另一用户购买。
XStoreShowGiftingUIResult	获取对 XStoreShowGiftingUIAsync 调用的结果。
XStoreShowProductPageUIAsync	直接打开商店应用到指定 ProductId 的详细信息页面。
XStoreShowProductPageUIResult	获取对 XStoreShowProductPageUIAsync 调用的结果。
XStoreShowPurchaseUIAsync	允许游戏请求购买特定的商店产品。
XStoreShowPurchaseUIResult	获取对 XStoreShowPurchaseUIAsync 调用的结果。
XStoreShowRateAndReviewUIAsync	显示一个系统对话框弹窗，允许用户提供评论或拒绝提供评论。
XStoreShowRateAndReviewUIResult	获取对 XStoreShowRateAndReviewUIAsync 调用的结果。
XStoreShowRedeemTokenUIAsync	为当前用户触发指定令牌的令牌兑换。
XStoreShowRedeemTokenUIResult	获取对 XStoreShowRedeemTokenUIAsync 调用的结果。
XStoreUnregisterGameLicenseChanged	取消注册指定的游戏许可证更改回调。
XStoreUnregisterPackageLicenseLost	取消注册指定的商店许可证丢失回调。

结构

结构	说明
XStoreAddonLicense	描述加载项许可证。
XStoreAvailability	描述产品的可用性。
XStoreCanAcquireLicenseResult	获取对 XStoreCanAcquireLicenseForPackageAsync 或 XStoreCanAcquireLicenseForStoreIdAsync 调用的结果。
XStoreCollectionData	描述商店集合。
XStoreConsumableResult	表示消耗品的数量。
XStoreGameLicense	描述游戏许可证。
XStoreImage	描述图像。
XStorePackageUpdate	描述包更新。
XStorePrice	商店价格信息。
XStoreProduct	描述商店产品。
XStoreRateAndReviewResult	对 XStoreShowRateAndReviewUIAsync 调用的结果。
XStoreSku	描述商店 SKU。
XStoreSubscriptionInfo	包含订阅信息。
XStoreVideo	描述商店视频。

枚举

枚举	说明
XStoreCanLicenseStatus	指示用户是否能够许可包。
XStoreDurationUnit	持续时间值的单位。
XStoreProductKind	指示产品类型。

错误代码

以下错误代码可能由 XStore API 返回。有关完整列表，请参阅错误代码。

代码	值	说明
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 次授权尝试。

概念文档

另请参阅

System API 参考
XPackage API 参考
商业概述

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XStore（API 内容）

XStore

函数

结构

枚举

错误代码

概念文档

另请参阅

​XStore

​函数

​结构

​枚举

​错误代码

​概念文档

​另请参阅

XStore

函数

结构

枚举

错误代码

概念文档

另请参阅