XStoreAcquireLicenseForPackageAsync
为用户有权使用的、面向当前游戏的已安装 DLC 包(带包的耐用型产品类型)获取许可证。 可使用 XStoreRegisterPackageLicenseLost 监视从此 API 获取的许可证是否丢失。此 API 不适用于不带包的耐用型加载项。
语法
参数
storeContextHandle _In_类型:XStoreContextHandle 由 XStoreCreateContext 返回的用户的商店上下文句柄。 packageIdentifier _In_z_
类型:char* 用于唯一标识商店包的字符串。包标识符通常作为 XPackageEnumeratePackages 操作的一部分返回。有关包标识符的详细信息,请参阅管理和授权可下载内容 (DLC)。 async _Inout_
类型:XAsyncBlock* 定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
要检索包许可证以及此函数调用的执行结果,请在调用此函数后调用 XStoreAcquireLicenseForPackageResult。 如果要检查包是否可以授权,请调用 XStoreCanAcquireLicenseForPackageAsync。 获得许可证后,必须通过调用 XStoreIsLicenseValid 检查其是否有效。 调用 XPackageMountWithUiAsync 时将自动获取许可证。 如果无法获取许可证,则包装载失败。 此代码片段展示了使用以下 API 的示例:- XStoreAcquireLicenseForPackageAsync
- XStoreAcquireLicenseForPackageResult
- XStoreIsLicenseValid
- XStoreCloseLicenseHandle
- XStoreRegisterPackageLicenseLost
- XStoreUnregisterPackageLicenseLost
要求
头文件: XStore.h(包含在 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStoreRegisterPackageLicenseLost
XStoreUnregisterPackageLicenseLost
XStoreCanAcquireLicenseForPackageAsync
XStoreCanAcquireLicenseForPackageResult
管理和授权可下载内容 (DLC)
