XPackageMountWithUiAsync
异步装载指定内容的安装,并返回其装载句柄。 如果内容根据所有已登录用户的家长设置存在年龄限制,则会显示用户家长同意 UI。语法
参数
packageIdentifier _In_z_类型:const char * 用于在磁盘上唯一标识已安装包的字符串。 传入从 XPackageEnumerationCallback 返回的 XPackageDetails 结构中的 packageIdentifier 字段。 有关包标识符的详细信息,请参阅管理和授权可下载内容 (DLC)。 async _Inout_
类型:XAsyncBlock * 用于监视异步调用状态的 XAsyncBlock。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
如果此 API 装载的内容对所有已登录用户来说都不符合年龄要求,则该 API 会向用户显示家长同意提示。 如果成年用户在提示中同意家长授权,则该 API 会尝试装载包。 如果成年用户在提示中拒绝家长授权,则该 API 将无法装载包。 此 API 会自动调用 XStoreAcquireLicenseForPackageAsync / Result 和 XStoreIsLicenseValid。 如果 API 无法获取 DLC 的有效许可证,则装载将失败。 在此代码示例中,如果内容有年龄限制,游戏将以黑白方式呈现 DLC。 当用户选择要使用的 DLC 时,游戏中的外部代码会调用MountDlc。
要求
头文件: XPackage.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XPackageMountWithUiResult XPackageXPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
如何为 PC 和 XBOX One 创建和使用可下载内容包 (DLC)
