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
