XStoreDownloadPackageUpdatesAsync

下载指定包的更新而不安装它们。 这使游戏可以控制何时安装更新，以便在用户玩游戏期间防止游戏关闭。

语法

HRESULT XStoreDownloadPackageUpdatesAsync(  
         const XStoreContextHandle storeContextHandle,  
         const char** packageIdentifiers,  
         size_t packageIdentifiersCount,  
         XAsyncBlock* async  
)  

参数

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