Skip to main content

XStoreDownloadAndInstallPackagesAsync

下載並安裝指定的市集套件。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
XStoreCreateContext 所傳回之使用者的市集內容控制代碼。 storeIds   _In_z_count_(storeIdsCount)
類型:char**
套件識別碼字串的清單。 套件識別碼可唯一識別 Microsoft Store 中的套件。如需套件識別碼的詳細資訊,請參閱管理可下載內容 (DLC) 並授權。 storeIdsCount   _In_
類型:size_t
storeIds 中的識別碼數目。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

若要擷取此函式的下載和安裝結果,請在呼叫此函式之後呼叫 XStoreDownloadAndInstallPackagesResult。若要擷取已下載並安裝的項目數目,請在呼叫此函式之後呼叫 XStoreDownloadAndInstallPackagesResultCount。結果計數函式很重要,因為它可讓您判斷要傳遞給結果函式的適當陣列大小。 從執行中的遊戲呼叫此 API 時,下載會被視為高優先順序,並依照此 API 的 storeIds 參數中指定的順序,排在佇列的最前面。 下列程式碼片段示範如何下載並安裝市集套件。

需求

標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XStore
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
Last modified on October 6, 2026