Skip to main content

XStoreDownloadAndInstallPackagesAsync

下载并安装指定的应用商店包。

语法

参数

storeContextHandle   _In_
类型:XStoreContextHandle
XStoreCreateContext 返回的用户的应用商店上下文句柄。 storeIds   _In_z_count_(storeIdsCount)
类型:char**
包标识符字符串的列表。 包标识符唯一标识来自 Microsoft 应用商店的包。有关包标识符的详细信息,请参阅管理和授权可下载内容 (DLC) storeIdsCount   _In_
类型:size_t
storeIds 中的 ID 数量。 async   _Inout_
类型:XAsyncBlock*
定义正在执行的异步工作的 XAsyncBlock。可使用 XAsyncBlock 轮询调用状态并检索调用结果。有关详细信息,请参阅 XAsyncBlock

返回值

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

备注

要检索此函数的下载和安装结果,请在调用此函数后调用 XStoreDownloadAndInstallPackagesResult。要检索已下载和已安装的项数,请在调用此函数后调用 XStoreDownloadAndInstallPackagesResultCount。结果计数函数很重要,因为它可以让你确定要传递给结果函数的合适数组大小。 当从正在运行的游戏中调用此 API 时,下载将被视为高优先级,它们将按此 API 的 storeIds 参数中指定的顺序排在队列前面。 以下代码片段演示了下载和安装应用商店包的示例。

要求

头文件: XStore.h(包含于 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

概念文档

另请参阅

XStore
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
最后修改于 2026年8月24日