Skip to main content

XStoreShowRedeemTokenUIAsync

为当前用户触发指定令牌的令牌兑换。

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 为用户返回的商店上下文句柄。 token   _In_z_
类型:char*
要兑换的令牌。此值不能为空或 null,如果要在不提供代码以在 UI 中预填充的情况下调出 UI,请传入单个空格 ” ”。 allowedStoreIds   _In_z_count_(allowedStoreIdsCount)
类型:char**
允许你限制 5x5 代码仅适用于特定产品。 allowedStoreIdsCount   _In_
类型:size_t
allowedStoreIds 中的元素数量。 disallowCsvRedemption   _In_
类型:bool
阻止兑换 CSV(礼品卡/货币样式的 5x5)。 async   _Inout_
类型:XAsyncBlock*
定义正在完成的异步工作的 XAsyncBlockXAsyncBlock 可用于轮询调用的状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

要检索此函数调用的执行结果,请在调用此函数之后调用 XStoreShowRedeemTokenUIResult 以下代码片段展示了启动令牌兑换 UI 的示例。

要求

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

另请参阅

XStore
XStoreShowRedeemTokenUIResult
最后修改于 2026年8月24日