Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

检索可授予许可证的内容的预览许可证,包括带包或不带包的 Durables,以及当前已插入光盘中的内容。 此 API 允许游戏查看产品是否可获取许可证,但不会实际获取许可证。

语法

参数

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

返回值

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

备注

XStoreCanAcquireLicenseForStoreIdAsync 使游戏能够确定用户是否可以为某项特定内容获取许可证,而不必实际获取该许可证并占用该用户的并发许可名额。 此函数不需要用于当前正在运行的游戏,因为该游戏已具有许可证,但可以用于确定用户是否拥有同一发行商的其他游戏或内容。 例如,游戏可以使用此 API 来确定是否奖励拥有该游戏早期版本(数字版或插入的光盘版)的用户,或者向用户追加销售产品。 要检索预览许可证以及此函数的执行结果,请在调用此函数之后调用 XStoreCanAcquireLicenseForStoreIdResult 以下代码片段演示了如何使用以下 API:

要求

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

概念文档

另请参阅

XStore
XStoreCanAcquireLicenseForStoreIdResult
如何使用不带包的 Durable
向玩家授予附加内容的访问权限
最后修改于 2026年8月24日