XStoreCanAcquireLicenseForStoreIdAsync
检索可授予许可证的内容的预览许可证,包括带包或不带包的 Durables,以及当前已插入光盘中的内容。 此 API 允许游戏查看产品是否可获取许可证,但不会实际获取许可证。语法
参数
storeContextHandle _In_类型:XStoreContextHandle 由 XStoreCreateContext 返回的用户的应用商店上下文句柄。 storeProductId _In_z_
类型:char* 要检查的产品的 StoreID async _Inout_
类型:XAsyncBlock* 定义正在执行的异步工作的 XAsyncBlock。 可使用 XAsyncBlock 轮询调用状态并检索调用结果。 有关详细信息,请参阅 XAsyncBlock。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
XStoreCanAcquireLicenseForStoreIdAsync 使游戏能够确定用户是否可以为某项特定内容获取许可证,而不必实际获取该许可证并占用该用户的并发许可名额。 此函数不需要用于当前正在运行的游戏,因为该游戏已具有许可证,但可以用于确定用户是否拥有同一发行商的其他游戏或内容。 例如,游戏可以使用此 API 来确定是否奖励拥有该游戏早期版本(数字版或插入的光盘版)的用户,或者向用户追加销售产品。 要检索预览许可证以及此函数的执行结果,请在调用此函数之后调用 XStoreCanAcquireLicenseForStoreIdResult。 以下代码片段演示了如何使用以下 API:- XStoreCanAcquireLicenseForStoreIdAsync
- XStoreCanAcquireLicenseForStoreIdResult
要求
头文件: XStore.h(包含于 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XStoreXStoreCanAcquireLicenseForStoreIdResult
如何使用不带包的 Durable
向玩家授予附加内容的访问权限
