跳转到主要内容

​
XStoreDownloadPackageUpdatesAsync

此 API 无法按预期工作，因为 XBOX 上的更新会在下载时同步安装。 如果更新针对的是游戏，游戏将终止。 如果更新针对的是 DLC，并且 DLC 包当前已装载，游戏将终止。请改用 XStoreDownloadAndInstallPackageUpdatesAsync。
下载指定包的更新但不安装它们。这允许你的游戏控制更新的安装时机，以防止在用户玩游戏时游戏被关闭。

​
语法

​
参数

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

​
返回值

类型：HRESULT 成功时返回 S_OK；否则返回错误代码。

​
备注

此函数仅下载更新，但不安装它。要在一次调用中下载并安装更新，请使用 XStoreDownloadAndInstallPackageUpdatesAsync 函数。要检索此函数的结果，请在调用此函数后调用 XStoreDownloadPackageUpdatesResult。有关用法示例，请参阅 XStoreQueryGameAndDlcPackageUpdatesAsync。 当从正在运行的游戏中调用此 API 时，下载将被视为高优先级，它们将按此 API 的 storeIds 参数中指定的顺序排在队列前面。

​
要求

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

​
另请参阅

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
最后修改于 2026年10月19日