XStoreDownloadAndInstallPackageUpdatesAsync

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

语法

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

参数

storeContextHandle _In_
类型：XStoreContextHandle

XStoreCreateContext 返回的用户的应用商店上下文句柄。

packageIdentifiers _In_z_count_(packageIdentifiersCount)
类型：char**

程序包标识符字符串的列表。 程序包标识符唯一地标识 Microsoft Store 中的程序包。 有关包标识符的详细信息，请参阅管理和许可可下载内容 (DLC)。

packageIdentifiersCount _In_
类型：size_t

packageIdentifiers 中的标识符数。

async _Inout_
类型：XAsyncBlock*

用于定义正在进行的异步工作的 XAsyncBlock。 XAsyncBlock 可用于轮询调用的状态和检索调用结果。 有关详细信息，请参阅 XAsyncBlock。

返回值

类型：HRESULT

HRESULT 成功或错误代码。

备注

此函数下载并安装对指定应用商店包的更新。 如果您想要下载更新而不进行安装，请调用 XStoreDownloadPackageUpdatesAsync。 游戏运行时不安装下载很有用，可以避免打扰用户玩游戏。 要检索下载和安装更新的结果，请在调用此函数后调用 XStoreDownloadAndInstallPackageUpdatesResult。 有关使用示例，请参阅 XStoreQueryGameAndDlcPackageUpdatesAsync。

从正在运行的游戏调用此 API 时，下载将被视为高优先级，并且它们将按照在此 API 的 storeIds 参数中指定它们的顺序转到队列的开头。

要求

头文件：XStore.h（包含在 XGameRuntime.h 中）

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XStore
XStoreDownloadAndInstallPackageUpdatesResult
XStoreDownloadPackageUpdatesAsync