Skip to main content

XPackageEnumeratePackages

查找已安装或正在安装且与调用进程相关的程序包。

语法

参数

kind   _In_
类型:XPackageKind
要枚举的安装程序包的类型。 scope   _In_
类型:XPackageEnumerationScope
安装程序包的范围。 context   _In_opt_
类型:void*
要传递给 callback 参数中指定的回调的上下文。 callback   _In_
类型:XPackageEnumerationCallback*
在完成时要调用的回调。

返回值

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

备注

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
使用 XPackageEnumeratePackages 查找已安装或正在安装且与调用进程相关的程序包。此函数可以查找内容程序包以及应用程序包。它通过 XPackageDetails 结构提供有关安装的详细信息。 如果程序包仍在安装中,installing 属性将设置为 true,并且你可以创建安装监视器,让程序包的标识符监视安装进度。 没有通用的安装队列通知;其意图是使用 XPackageEnumeratePackages 来显示和跟踪正在进行的项。也没有停止、启动或取消安装的 API。从游戏的角度来看,安装应该自动进行。错误会自动重试,对游戏不可见。 使用值 XPackageKind::Game 调用该 API 时,根据 XPackageEnumerationScope 值,其输出为: 使用值 XPackageKind::Content 调用该 API 时,根据 XPackageEnumerationScope 值,其输出为: 示例:

要求

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

概念性文档

另请参阅

XPackage
特许经营游戏中心
如何为 PC 和 XBOX One 创建和使用可下载内容程序包 (DLC)
最后修改于 2026年8月24日