XStoreQueryPackageUpdatesAsync
检索参数中指定的包的可用更新列表。使用此列表下载和安装更新。语法
参数
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 成功或错误代码。备注
要获取当前正在运行的游戏的包标识符,请使用 XPackageGetCurrentProcessPackageIdentifier,或使用 XPackageEnumeratePackages 获取 DLC 和相关游戏的包标识符。 要检索可用更新列表以及此函数的执行结果,请在调用此函数后调用 XStoreQueryPackageUpdatesResult。要获取要检索的更新数量,请在调用此函数后调用 XStoreQueryPackageUpdatesResultCount。结果计数函数很重要,因为它可以让你确定要传递给结果函数的合适数组大小。 以下代码片段演示了检索指定包的游戏和可选更新的示例。要求
头文件: XStore.h(包含于 XGameRuntime.h 中) 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XStoreXStoreQueryPackageUpdatesResult
XStoreQueryPackageUpdatesResultCount
