Skip to main content

XStoreQueryLicenseTokenAsync

向调用游戏提供一个不透明的 JSON Web 令牌,该令牌可传递给游戏的服务以验证权益并进行 B2B 调用。有关详细信息,请参阅许可证令牌概述

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 productIds   _In_z_count_(productIdsCount)
类型:char**
要检索令牌的产品 ID 数组。 productIdsCount   _In_
类型:size_t
传递到 productIds 的数组中的 ID 数量。 customDeveloperString   _In_z_
类型:char*
一个来回传递到令牌中的值。此值通常由服务选择。可以插入类似 userId 或 email 之类的内容,以在许可证令牌中跟踪用户的令牌。许可证令牌用作所有权凭证。 不能为 null 或空字符串。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

要检索 JSON Web 令牌以及此函数的执行结果,请在调用此函数后调用 XStoreQueryLicenseTokenResult。要检索 JSON Web 令牌的大小,请在调用此函数后调用 XStoreQueryLicenseTokenResultSize。知道令牌的大小将允许你更高效地检索它。 许可证令牌是 Base64 编码的 JSON Web 令牌。令牌的有效负载是一个 Base64 编码字符串,可转换为 JSON 值,从而可在服务器上用于验证。 以下代码片段演示了检索许可证令牌的示例。

要求

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

概念文档

另请参阅

XStore 许可证令牌概述 XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
最后修改于 2026年8月28日