Skip to main content

XStoreQueryAddOnLicensesAsync

枚举附加到数字游戏许可证的任何 Durable 附加内容的许可证。 这仅适用于不带包类型的 Durable,并且只能用于数字许可证,不能用于光盘许可证。 使用光盘许可证运行此函数将返回空结果,即使用户拥有或可以获取许可证的单个 Durable 存在也是如此。 对于光盘场景,请改用 XStoreAcquireLicenseForDurablesAsync

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。 可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

要检索附加内容许可证以及此函数的执行结果,请在调用此函数后调用 XStoreQueryAddonLicensesResult。 要检索通过此函数获取的许可证数量,请在调用此函数后调用 XStoreQueryAddonLicensesResultCount。 结果计数函数很重要,因为它可以让你确定要传递给结果函数的合适数组大小。 以下代码片段演示了检索用户拥有或可获取许可证的 Durable 附加内容许可证(不带包)的示例:

要求

头文件: XStore.h(包含于 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XStore
XStoreQueryAddonLicensesResult
XStoreQueryAddonLicensesResultCount
最后修改于 2026年8月24日