Skip to main content

​
XStoreDownloadPackageUpdatesAsync

此 API 無法如預期運作，因為 XBOX 上的更新會在下載時同步安裝。 如果更新是針對遊戲，遊戲將會終止。 如果更新是針對 DLC，且 DLC 套件目前已掛接，遊戲將會終止。請改用 XStoreDownloadAndInstallPackageUpdatesAsync。
下載指定套件的更新但不進行安裝。這可讓您的遊戲控制何時安裝更新，以避免在使用者遊玩時關閉遊戲。

​
語法

​
參數

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 如果成功，則傳回 S_OK；否則傳回錯誤碼。

​
備註

此函式只會下載更新，但不會安裝更新。若要在一次呼叫中下載並安裝更新，請使用 XStoreDownloadAndInstallPackageUpdatesAsync 函式。若要擷取此函式的結果，請在呼叫此函式之後呼叫 XStoreDownloadPackageUpdatesResult。如需使用範例，請參閱 XStoreQueryGameAndDlcPackageUpdatesAsync。 從執行中的遊戲呼叫此 API 時，下載會被視為高優先順序，並依照此 API 的 storeIds 參數中指定的順序，排在佇列的最前面。

​
需求

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

​
另請參閱

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
Last modified on October 6, 2026