Skip to main content

XStoreGetUserCollectionsIdAsync

获取客户集合 ID。然后可使用此 ID 通过 B2B 调用从你自己的服务验证用户的权益。此 API 用于通过你的服务管理产品中概述的流程。

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 serviceTicket   _In_z_
类型:char*
可供后端服务用于对用户和服务进行授权的 Azure 票证。这使你能够从服务取回一个票证,然后可以将该票证中继到你自己的服务器。然后你的服务器可以存储此票证并将其用于 B2B 调用,以检查所有权或授予访问权限。 publisherUserId   _In_z_
类型:char*
由开发者生成的字符串,旨在将当前用户标识为游戏、开发者或发行商所拥有的服务的成员或访客。此字符串的内容由开发者决定,可以留空。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

在 PC 上,如果启用了 XBOX services,则此 API 将返回当前登录到应用商店的用户的信息,而不一定是玩游戏的用户的信息。如果你的游戏运行在 XBOX 主机上,或者在 PC 上启用了 XBOX services,我们建议使用 XSTS 委托授权对集合和许可证预览终结点进行 B2B 调用,以确保检查的是当前正在玩游戏的用户的权益。 要检索用户的集合 ID 以及此函数的执行结果,请在调用此函数后调用 XStoreGetUserCollectionsIdResult。要检索用户集合 ID 的大小,请调用 XStoreGetUserCollectionsIdResultSize。知道结果的大小可让你更高效地检索结果。 以下代码片段演示了检索客户集合 ID 的示例。

要求

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

概念文档

另请参阅

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