Skip to main content

XStoreGetUserPurchaseIdAsync

获取客户购买 ID。此 ID 检索一个 Microsoft Store ID 密钥,该密钥可用于代表当前用户授予免费产品的权益。此 API 用于通过你的服务管理产品中概述的流程

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 serviceTicket   _In_z_
类型:char*
与购买关联的服务票证。 publisherUserId   _In_z_
类型:char*
包含发行商用户 ID 的字符串。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

要检索客户的购买 ID 以及此函数的执行结果,请在调用此函数后调用 XStoreGetUserPurchaseIdResult。要检索客户购买 ID 的大小,请在调用此函数后调用 XStoreGetUSerPurchaseIdResultSize。知道结果大小将有助于你更高效地读取结果。 以下代码片段演示了检索客户购买 ID 的示例。

要求

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

概念文档

另请参阅

XStore
XStoreGetUserPurchaseIdResult
XStoreGetUSerPurchaseIdResultSize
通过你的服务管理产品
最后修改于 2026年8月24日