Skip to main content

XStoreAcquireLicenseForDurablesAsync

获取 DLC(带包的耐用型产品)、不带包的耐用型产品或耐用型加载项产品的许可证。

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的商店上下文句柄。 storeId   _In_z_
类型:char*
要获取许可证的耐用型产品的商店 ID。 async   _Inout_
类型:XAsyncBlock*
定义异步工作的 XAsyncBlock。 使用 XAsyncBlock 检查调用状态并获取调用结果。 有关详细信息,请参阅 XAsyncBlock

返回值

类型:HRESULT 成功时返回 S_OK,否则返回错误代码。

备注

此 API 尝试为请求的耐用型产品获取许可证。 如果是设备首次获取许可证,则会进行服务调用,因此需要联网连接。 后续对同一许可证的调用可能因缓存而更快,但许可证随时可能失效。 在主机上,脱机访问要求所属账户已启用”主 XBOX”,并且必须先在联机状态下获取一次许可证。 在 PC 上,脱机访问要求为拥有该许可证的账户设置”脱机权限”,并且必须先在联机状态下获取一次许可证。 可使用 XStoreRegisterPackageLicenseLost 监视从此 API 获取的许可证是否丢失。

要求

头文件: XStore.h 库: xgameruntime.lib 支持的平台:Windows、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XStore
XAsyncBlock
XStoreAcquireLicenseForDurablesResult
如何使用不带包的耐用型产品
授予玩家访问加载项内容的权限
最后修改于 2026年8月24日