Skip to main content

XPackageMountWithUiAsync

异步装载指定内容的安装,并返回其装载句柄。 如果内容根据所有已登录用户的家长设置存在年龄限制,则会显示用户家长同意 UI。

语法

参数

packageIdentifier  _In_z_
类型:const char *
用于在磁盘上唯一标识已安装包的字符串。 传入从 XPackageEnumerationCallback 返回的 XPackageDetails 结构中的 packageIdentifier 字段。 有关包标识符的详细信息,请参阅管理和授权可下载内容 (DLC) async  _Inout_
类型:XAsyncBlock *
用于监视异步调用状态的 XAsyncBlock

返回值

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

备注

如果此 API 装载的内容对所有已登录用户来说都不符合年龄要求,则该 API 会向用户显示家长同意提示。 如果成年用户在提示中同意家长授权,则该 API 会尝试装载包。 如果成年用户在提示中拒绝家长授权,则该 API 将无法装载包。 此 API 会自动调用 XStoreAcquireLicenseForPackageAsync / ResultXStoreIsLicenseValid。 如果 API 无法获取 DLC 的有效许可证,则装载将失败。 在此代码示例中,如果内容有年龄限制,游戏将以黑白方式呈现 DLC。 当用户选择要使用的 DLC 时,游戏中的外部代码会调用 MountDlc

要求

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

概念文档

另请参阅

XPackageMountWithUiResult XPackage
XPackageEnumeratePackages
XPackageEnumerationCallback
XPackageDetails
XPackageGetMountPath
XPackageGetMountPathSize
如何为 PC 和 XBOX One 创建和使用可下载内容包 (DLC)
最后修改于 2026年8月24日